Notion API 連接

在此說明文件中

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


您可以從 Notion 管理個人存取權限。請從 設定 開啟開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。請造訪我們的 開發人員中心 以取得說明文件、資源和連接管理工具。

提示: 工作空間擁有者可管理工作空間中的所有連接。進一步了解 企業版連接設定 →

正在尋找管理員權杖嗎?此頁面上的權杖適用於單一工作空間並處理頁面內容。如果您需要執行組織管理工作(例如匯出、法務保存或登出使用者),請參閱 企業版組織的管理員 API。

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

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

  3. 請開啟 開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。

  4. 按一下 + 建立連接。

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

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

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

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

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

整合資訊

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

整合選單 - 建立

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

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

建立公開連接時,你可以選擇誰能安裝:

  • 任何工作空間:任何人都能將你的連接安裝到自己的 Notion 工作空間。

  • 選定的工作空間:只有你列出的工作空間能安裝你的連接。

如果你只為自己的公司建置功能,不想讓其他組織安裝,請選擇 選定的工作空間。

每次有人安裝你的連接時,Notion 都會檢查對方的工作空間是否在你的列表中。如果不在,安裝就會中止,對方也會看到錯誤訊息。

只有任何人都能安裝的連接,才會列在連接庫中。僅限選定工作空間安裝的連接不會顯示在連接庫中。

提示:你會在建立連接時選擇這項設定。如果之後想改用其他設定,請建立新的連接。

你擁有的連接,會顯示在以下工作空間的開發者入口網站中:獲准安裝該連接、已安裝該連接,或是你用來建置該連接的工作空間。

每個公開連接都有一個用來建置和測試的工作空間。你可以切換到其他工作空間,不必從頭開始。

  1. 在開發者入口網站中開啟你的連接。

  2. 前往該連接的設定。

  3. 選取你要用來建置的工作空間。

Notion 會讓你的連接與所選工作空間建立連接。你不必建立新的連接。

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

  • 內容功能:

    • 僅讀取內容

    • 僅寫入內容

    • 插入內容

  • 使用者功能

    • 沒有使用者資訊

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

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

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

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

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

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

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

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

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

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

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

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

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

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


給予回饋

這項資源有用嗎?


Powered by Molteo