Notion API 連接
透過 Notion 的 API,你可以建立自訂的內部連接。部分合作夥伴也可能需要 API 權杖,才能將平台連結至你的 Notion 工作空間。以下將帶你完成設定。
您可以從 Notion 管理個人存取權限。請從 設定 開啟開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。請造訪我們的 開發人員中心 以取得說明文件、資源和連接管理工具。
提示:每個連接都有一位或多位負責人,每位負責人都可以管理連接並取得 API 權杖。誰可以建立連接,取決於你的方案和工作空間設定。深入了解 企業版連接設定 →
正在尋找管理員權杖嗎?此頁面上的權杖適用於單一工作空間並處理頁面內容。如果您需要執行組織管理工作(例如匯出、法務保存或登出使用者),請參閱 企業版組織的管理員 API。
我需要哪種權杖? Notion 使用幾種不同的權杖。你為內部連接複製的是 API 權杖,也是本文介紹的權杖。個人存取權杖與你的帳號綁定。OAuth 則用於授權你登入的應用程式。如果合作夥伴平台要求提供你建立的連接所使用的權杖,請使用 API 權杖。
在左側側邊欄中,導覽至
設定,然後前往連接分頁。誰可以建立連接取決於你的工作空間。在免費版和 Plus 版中,只有工作空間擁有者可以建立連接。在商業版和企業版中,工作空間擁有者也可以讓成員或特定群組中的成員建立連接。如果你無法建立連接,請詢問工作空間擁有者。
請開啟 開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。
按一下
+ 建立連接。為你的連接設定
名稱。你也可以選擇上傳一張圖片作為標誌。使用下拉式選單指定你想將此連接用於哪個
關聯的工作空間。
注意: 請確保你在網頁工作階段中登入 Notion 的帳號,與你在桌面版使用的帳號相同。否則,你將無法看到正確的帳號與工作空間!

你的內部連接已成功新增!現在你可以在工作空間的
設定選單 →連接中找到它。點擊內部連接旁的
•••以複製其 API 權杖。你的團隊建立任何基於 API 的自動化或工作流程,或要將工作空間連結至某些合作夥伴平台時,都需要這個權杖。

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

每個內部連接至少有一位擁有者。擁有者可以變更連接的設定並取得其 API 權杖。你可以分享擁有權,讓多人能管理同一個連接。如此一來,若有人職務異動或離職,工作也不會中斷。
若要新增或移除擁有者:
開啟開發者入口網站 (Developer Portal) 並選取你的連接。
開啟
連接擁有者分頁。新增成員或群組作為擁有者,或移除現有擁有者。
關於連接擁有者,請注意以下事項:
只有正式成員和工作空間擁有者才能成為擁有者。訪客和存取權限受限的成員則不行。
你可以新增誰作為擁有者,也取決於你的工作空間關於「誰可以建立連接」的設定。
連接必須始終保留至少一位擁有者,因此你無法移除最後一位擁有者。
如果你是工作空間擁有者且需要接管連接,請先將自己新增為擁有者。
如果最後一位擁有者離開工作空間,該連接的 API 權杖會立即停止運作。
使用 Plus 版、商業版或企業版時,你可以透過瀏覽器或桌面版應用程式分享連接的擁有權。
所有新加入的連接最初都是內部連接。如果你正在開發公開連接,請先依照上述說明建立內部連接。
然後,請依照我們 開發人員指南 的指示,把它轉換為公開連接。
建立公開連接時,你可以選擇允許誰安裝:
任何工作空間:任何人都可以在自己的 Notion 工作空間中安裝你的連接。選取的工作空間:只有你列出的工作空間可以安裝你的連接。
如果你只想為自己的公司建立連接,不希望其他組織安裝,就選擇 選取的工作空間
每次有人安裝你的連接時,Notion 都會檢查對方的工作空間是否在你的列表中。如果不在列表中,安裝就會停止,並顯示錯誤訊息。
只有任何人都能安裝的連接,才會列在連接庫中。僅限選取的工作空間安裝的連接不會顯示在連接庫中。
提示:建立連接時就要選好這項設定。如果之後需要改用其他設定,請建立新的連接。
你擁有的連接,會顯示在以下工作空間的開發者入口網站中:獲准安裝該連接的工作空間、已安裝該連接的工作空間,以及你建置該連接的工作空間。
每個公開連接都有一個用來建置和測試的工作空間。你可以改用其他工作空間,不必從頭開始。
在開發者入口網站中開啟你的連接
前往連接設定
選取你想用來建置連接的工作空間
Notion 會將你的連接接到選取的工作空間,不必建立新連接。
在應用程式設定過程中,開發人員將能夠選擇使用者所需的存取層級。
內容功能:
僅讀取內容
僅寫入內容
插入內容
使用者功能
沒有使用者資訊
讀取使用者資訊(不包含使用者的電子郵件地址)
讀取使用者資訊(包含電子郵件)
當使用者安裝連接時,將會顯示此存取層級。它也會顯示在已新增該連接之任何頁面的 共用 選單中。進一步了解如何在工作空間中安裝連接 →
Webhook 連接讓連接能夠即時監控並回應 Notion 工作空間中的變更。
當與你的 連接 共享的頁面或資料庫發生變更時,Notion 會自動傳送通知到你的 Webhook 端點,讓該連接能立即更新其他工具、執行自動化任務或呈現最新變更。
如需操作說明,請造訪我們的 開發者文件。
Webhook 動作與 Webhook 連接有些相似之處——兩者都有觸發條件,且都能將事件傳送到第三方服務。然而,Webhook 連接提供了更廣泛的功能:
它們可以監控多個工作空間的活動。
它們可以處理無限數量的動作。
相比之下,Webhook 動作是為更簡單的使用案例所設計,並透過資料庫自動化進行設定,且觸發條件有限。
