Notion API

概念

Notion API

定義

Notion 提供的 REST API，允許外部程式讀寫 Notion 資料庫、頁面等資源。需要建立 Internal Integration 並取得 token 才能使用。

關鍵數據點（附來源）

  • 建立 Integration 後，必須手動將資料庫 Share 給 Integration（Can edit 權限），否則回 403。（github-actions-notion-commit-log）
  • Database ID 從 Notion 網址中擷取，注意不要混入 View ID（?v= 後的值）。（github-actions-notion-commit-log）
  • API 版本需在 Header 指定（Notion-Version: 2022-06-28）。（github-actions-notion-commit-log）
  • Rate limit 為 3 req/s，大量寫入時需注意。（github-actions-notion-commit-log）

前提與局限性

  • Integration token 是機密，只能存放在安全的環境變數中。
  • API 功能有限制，部分 Notion 功能無法透過 API 操作。
  • token 過期後需手動更新。

衝突標記

（無）

關聯概念

  • [[GitHub Actions]]
  • [[Webhook 整合]]
  • [[API 金鑰管理]]