Notion API 連接

在此說明文件中

透過 Notion 的 API,你將能夠建立自訂的內部連接。我們的某些合作夥伴可能也需要內部連接權杖,才能將他們的平台連結至你的 Notion 工作空間——下方我們將帶你一步步完成設定。


請造訪我們的 開發人員中心 以取得說明文件、資源和連接管理工具。

注意: 工作空間擁有者可管理工作空間中的所有連接。進一步了解請點擊這裡 →

  1. 在左側側邊欄中,導覽至 設定,然後前往 連接 分頁。

  2. 只有工作空間擁有者才能存取 連接 分頁並建立整合。如果你不是管理員,請聯絡你的工作空間管理員或使用其他工作空間。

  3. 點擊底部的 開發你自己的連接 連結。

  4. 我的連接 將會在你的預設瀏覽器中開啟。點擊 + 建立連接 按鈕。

  5. 為你的連接設定 名稱。你也可以選擇上傳一張圖片作為 標誌

  6. 使用下拉式選單指定你想將此連接用於哪個 關聯的工作空間

    注意: 請確保你在網頁工作階段中登入 Notion 的帳號,與你在桌面版使用的帳號相同。否則,你將無法看到正確的帳號與工作空間!

  7. 你的內部連接已成功新增!現在你可以在工作空間的 設定 選單 → 連接 中找到它。

  8. 點擊內部連接旁的 ••• 以取得內部連接權杖。你在進行任何基於 API 的自動化或工作流程操作,或要將工作空間連結至某些合作夥伴平台時,都需要這個權杖。

注意: 內部連接是工作空間專屬的,因此若要變更關聯的工作空間,你必須建立新的連接。

所有新加入的連接最初都是內部連接。如果你正在開發公開連接,請先依照上述說明建立內部連接。

然後,請依照我們 開發人員指南 的指示,把它轉換為公開連接。

在應用程式設定過程中,開發人員將能夠選擇使用者所需的存取層級。

  • 內容功能:

    • 僅讀取內容

    • 僅寫入內容

    • 插入內容

  • 使用者功能

    • 沒有使用者資訊

    • 讀取使用者資訊(不包含使用者的電子郵件地址)

    • 讀取使用者資訊(包含電子郵件)

當使用者安裝連接時,將會顯示此存取層級。它也會顯示在已新增該連接之任何頁面的 共用 選單中。進一步了解如何在工作空間中安裝連接 →

Webhook 連接讓連接能夠即時監控並回應 Notion 工作空間中的變更。

當與你的 連接 共享的頁面或資料庫發生變更時,Notion 會自動傳送通知到你的 Webhook 端點,讓該連接能立即更新其他工具、執行自動化任務或呈現最新變更。

設定 Webhook 連接

如需操作說明,請造訪我們的 開發者文件

Webhook 連接目前不支援下列通知:

  • 使用者變更(包含工作空間成員資格變更、電子郵件/名稱更新,以及權限修改)。

  • 工作空間與團隊協作區設定變更。

若需要這類通知,請改用 稽核記錄檔

Webhook 動作與 Webhook 連接

Webhook 動作與 Webhook 連接有些相似之處——兩者都有觸發條件,且都能將事件傳送到第三方服務。然而,Webhook 連接提供了更廣泛的功能:

  • 它們可以監控多個工作空間的活動。

  • 它們可以處理無限數量的動作。

相比之下,Webhook 動作是為更簡單的使用案例所設計,並透過資料庫自動化進行設定,且觸發條件有限。


給予回饋

這項資源有用嗎?


Powered by Fruition