存取您的HubSpot API金鑰
上次更新時間: 六月 28, 2023
透過HubSpot API金鑰,您的開發人員可以使用HubSpot的API建立自訂應用程式。 每個金鑰都是特定於HubSpot帳戶,而不是單個用戶,而且一次只允許一個金鑰。
請注意:自 2022年11月30日起, HubSpot API密鑰已過時,不再受支援。 相反,您需要使用私人應用程式存取令牌或OAuth進行驗證。 進一步了解 此變更 ,以及如何 將API金鑰整合遷移 至使用私人應用程式。
如果你在帳戶中看到關於停用API金鑰的橫幅:
- 請確保您已遷移所有受影響的整合,然後 停用API金鑰。
- 若要檢查帳戶的API金鑰是否在過去七天內被使用,您可以 查看您的API金鑰通話記錄歷史。 通話記錄將不會顯示超過七天前使用密鑰提出的任何請求。
- 帳戶設定中的「已連線應用程式」 頁面上列出的應用程式不需要遷移,因為它們使用OAuth進行驗證。
- 開發人員API金鑰與標準HubSpot API金鑰分開,並且不會 被廢棄。 開發人員API金鑰用於管理與HubSpot應用程式相關的設定,包括 webhooks API 訂閱和 時間軸事件API事件 類型。
存取您的API金鑰
您必須擁有超級管理員權限才能存取帳戶的API金鑰。
- 了解更多
- 在左側邊欄選單中,導航至「整合」>「API金鑰」。
- 如果您的帳戶從未生成密鑰,請按一下「生成API密鑰」。
- 如果您已產生API金鑰,請按一下「顯示」以顯示金鑰。
- 顯示鑰匙後,按一下複製以複製鑰匙。 然後,您可以粘貼密鑰以提供給開發人員或在應用程序中使用它。
旋轉您的API金鑰
向開發人員提供您的API金鑰將使他們能夠通過HubSpot的API對您的帳戶進行更改,包括從已連接的電子郵件帳戶和其他第三方數據中讀取記錄的電子郵件。
為了增加安全性,請考慮每六個月旋轉一次HubSpot API金鑰。 旋轉您的HubSpot API金鑰將停用現有的API金鑰並產生新的金鑰。 HubSpot會顯示API金鑰的年齡,並建議您何時旋轉API金鑰。
如果API金鑰未在此時間範圍內旋轉,則每180天發送一次電子郵件通知給上次創建或旋轉API金鑰的超級管理員和用戶。
雖然這可能會產生停機時間並需要付出努力,但它通過防止惡意應用程序使用現有的API金鑰訪問您的HubSpot信息而增加了一層安全性。
要旋轉您的HubSpot API金鑰:
- 在您的HubSpot帳戶中,按一下主導航列中的設定圖示。
- 在左側邊欄選單中,導航至「整合」>「API金鑰」。
- 按一下操作下拉菜單,然後選擇旋轉鍵。
- 按一下旋轉並立即將此鑰匙過期。 選取reCAPTCHA核取方塊。 您現有的密鑰將被停用,並將創建一個新的API密鑰。
- 按一下複製並將應用程式使用的停用API金鑰替換為此新的API金鑰。
使用已停用的HubSpot API金鑰的API呼叫現在將失敗,任何使用該金鑰的應用程式將無法再存取您的資訊。
旋轉API金鑰不會影響您與Salesforce整合的連接。 但是,如果您已安裝自訂整合,則需要在旋轉後更新API金鑰。
請注意:當您旋轉API金鑰時,透過App Marketplace安裝的連線應用程式不會受到影響。
停用您的API金鑰
停用API金鑰不會建立新的金鑰。 使用已停用的HubSpot API金鑰的API呼叫將失敗,任何使用該金鑰的應用程式將無法再存取您的資訊。
要停用API金鑰,請按照以下步驟操作:- 了解更多
- 在左側邊欄選單中,導航至「整合」>「API金鑰」。
- 按一下「操作」下拉菜單。
- 按一下停用金鑰,然後按一下立即停用此金鑰。 選取reCAPTCHA核取方塊。
查看您的API審核日誌
您可以在「審核日誌」部分查看已檢視、建立或停用帳戶API金鑰的用戶的日期日誌。
- 了解更多
- 在左側邊欄選單中,導航至「整合」>「API金鑰」。
- 按一下稽核日誌標籤。
查看您的API Key呼叫日志
為了協助您調試其中一個集成,或確保您符合HubSpot的API使用指南,您可以查看過去7天的API金鑰呼叫記錄。
- 了解更多
- 在左側邊欄選單中,導航至「整合」>「API金鑰」。
- 在「通話記錄」分頁中,查看過去7天的所有活動。
