[Secure Transfer] 如何使用 API 功能

對象

• 正在使用 Secure Transfer 的客戶

目的

• 說明如何使用 Secure Transfer 的 API 功能的步驟。

注意事項

1. 本文章內容是根據 2026 年 6 月時的產品規格所製作，日後可能會在未經預告的情況下變更。
2. 使用本功能需要 Secure Transfer 的管理者權限。
3. Secure Transfer API 僅限已訂閱 HENNGE One Pro 方案的客戶使用。
4. 關於如何存取 Secure Transfer，請參考以下文章。
   [Secure Transfer] 登入步驟
5. Secure Transfer API 設有速率限制。
   詳細資訊請參考 關於速率限制。
6. 各端點的詳細資訊請參考 Developer Site。
   https://developers.hennge.com/

步驟

事前確認事項

Secure Transfer API 的端點如下所示。

https://api.transfer.hennge.com/{version_number}/

{version-number} 請指定要使用的 API 版本。
例如，若要使用 v1 版本的 API，請寫成 https://api.transfer.hennge.com/v1/。

發行驗證用戶端

1. 請從 Secure Transfer 管理介面進入［系統設定］－［API 密鑰名稱］。

   

2. 點選畫面右上方的［建立 API 密鑰名稱］。

   

3. 設定 API 密鑰名稱、詳細資訊、範圍，並確認使用條款後勾選，然後點選［建立］。

   

    

    

    

    

    

    

    

4. API 密鑰名稱會被新增，請複製並記錄下來。
   ※ 密鑰僅會在發行時顯示，關閉對話框後將無法再次顯示。
   若未儲存密鑰就關閉對話框，請刪除該 API 密鑰名稱並重新建立新的 API 密鑰名稱。
   ※ 密鑰的有效期限為發行日起一年內。

   

向端點發送請求記錄

Secure Transfer API 各端點的詳細資訊請參考 Developer Site。
Secure Transfer API Quick Start

※ 呼叫全部 API 時，請務必在標頭中包含 API 密鑰名稱。

關於速率限制

Secure Transfer API 設有速率限制。

若超過速率限制，將會回應 429 錯誤。
此外，回應標頭中會顯示可再次發送請求記錄前需等待的秒數。

・回應標頭範例
請於 reset-after 所示秒數過後再重新發送 API 請求記錄。

retry-after: 10

・回應主體範例

{
"error": {
"type": "too_many_requests",
"msg": "Too many requests"
}
}