跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。
Integrations

存取您的HubSpot API金鑰

上次更新時間: 十一月 30, 2022

套用至:

所有產品和版本

透過HubSpot API金鑰,你的開發人員可以使用HubSpot的API建立自訂應用程式。 每個鑰匙都是特定於HubSpot帳戶,而不是個人用戶,而且每次只允許一個鑰匙。

請注意: 2022年11月30日起, HubSpot API Keys將不推薦使用,並不再支援。 繼續使用HubSpot API Keys對您的帳戶和資料造成安全風險。 在此停用階段, HubSpot可能隨時停用您的金鑰。

相反,您應該使用私人應用程式存取令牌或OAuth進行驗證。 進一步了解 此變更, 以及如何 移轉API金鑰整合 以改用私人應用程式。

存取您的API密匙

你必須有超級管理員權限才能存取帳戶的API金鑰。 

  • 在 HubSpot 帳戶中,點擊主要導覽列中的「settings設定圖示」。
  • 在左側邊欄選單中,瀏覽至「整合」>「API鍵」。
    • 如果從未為帳戶生成鑰匙,請按一下生成API鑰匙
    • 如果你已經產生API金鑰,請點擊顯示以顯示你的金鑰。

show-API-key

  • 顯示鍵後,按一下複製以複製鍵。 然後,您可以貼上金鑰,提供給開發人員,或在應用程式中使用它。

旋轉您的API金鑰

將API金鑰提供給開發人員,將讓他們有完全的權限透過HubSpot的API更改帳戶,包括讀取連結電子郵件帳戶的已記錄電子郵件和其他第三方資料。

為了增加安全性,請考慮每六個月輪流一次HubSpot API金鑰。 旋轉您的HubSpot API金鑰將停用現有的API金鑰並產生新的金鑰。 HubSpot將顯示API鑰匙的舊期,並建議您應該何時旋轉API鑰匙。

如果上次創建或旋轉API金鑰的超讚管理員和用戶尚未在該時間範圍內旋轉API金鑰,我們會每180天向他們發送電子郵件通知。 

雖然這可能會造成停機時間並需要付出努力,但透過防止惡意應用程式使用現有的API金鑰存取您的HubSpot資訊,它增加了一層安全性。

要旋轉您的HubSpot API鑰匙:

  • 在您的HubSpot帳戶中,按一下主導覽列中的設定圖示
  • 在左側邊欄選單中,瀏覽至「整合」>「API鍵」。
  • 按一下[操作]下拉選單,然後選擇[旋轉鍵]。
  •  按一下旋轉並立即過期。 選擇reCAPTCHA核取方塊。你現有的金鑰將被停用,並創建新的API金鑰。
  •  按一下[複製] ,將應用程式使用的停用API金鑰替換為這個新的API金鑰。

使用停用的HubSpot API金鑰的API呼叫現在將失敗,使用金鑰的任何應用程式都將無法再存取您的資訊。 

旋轉API金鑰不會影響您與Salesforce整合的連線。 但是,如果您已安裝自訂整合,您需要在旋轉API密匙後更新API密匙。

請注意:旋轉API金鑰時,通過App Marketplace安裝的連線應用程式不會受到影響。

停用您的API密匙

停用API金鑰不會建立新的金鑰。 使用停用的HubSpot API金鑰的API呼叫將失敗,使用金鑰的任何應用程式將無法再存取您的資訊。

要停用API密匙:
  • 在 HubSpot 帳戶中,點擊主要導覽列中的「settings設定圖示」。
  • 在左側邊欄選單中,瀏覽至「整合」>「API鍵」。
  • 按一下[操作]下拉式選單。
  • 點擊「停用鑰匙」,然後點擊「立即停用此鑰匙」。 選擇reCAPTCHA核取方塊。 

查看API稽核日誌

您可以在「稽核日誌」部分查看已檢視、建立或停用帳戶API金鑰的用戶的日期日誌。 

  • 在 HubSpot 帳戶中,點擊主要導覽列中的「settings設定圖示」。
  • 在左側邊欄選單中,瀏覽至合」>「API鍵」。
  • 按一下稽核日誌標籤。
  • api-audit-log

查看您的API密匙呼叫日誌

為了協助您調整其中一個整合,或確保您符合HubSpot的API使用指南,您可以查看過去7天的API金鑰呼叫記錄。 

  • 在 HubSpot 帳戶中,點擊主要導覽列中的「settings設定圖示」。
  • 在左側邊欄選單中,瀏覽至「整合」>「API鍵」。
  • 在「呼叫日誌」標籤中,查看過去7天的所有活動。
call-log-api

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.