[Secure Transfer] API 功能的使用方法

概要

本說明針對使用 Secure Transfer 檔案・記錄資料匯出 API 功能的客戶，說明如何使用 API 功能的步驟。

注意事項

1. Secure Transfer API 為 HENNGE One Pro 方案的客戶專屬功能。
2. 使用本功能需具備 Secure Transfer 管理者權限。
3. 關於 Secure Transfer 的存取方式，請參考下方文章。
   ［Secure Transfer］登入步驟
4. Secure Transfer API 設有速率限制。
   詳細資訊請參考 關於速率限制。
5. 各端點的詳細資訊請參考 Developer Site。
   https://developers.hennge.com/ （外部連結）
6. 本文章內容係根據 2026 年 6 月時的產品規格撰寫，未來可能會有變更，恕不另行通知。

步驟

事前確認事項

Secure Transfer API 的端點如下所示。

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

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

驗證用 Client 發行

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

   

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

   

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

   

4. API 密鑰名稱會被新增，請複製資訊並妥善保存。
   ※ 密鑰僅於發行時顯示，關閉對話框後將無法再次顯示。
   若未保存密鑰即關閉對話框，請刪除該 API 密鑰名稱並重新建立新的 API 密鑰名稱。
   ※ 密鑰的有效期限為發行日起 1 年內。

   

向端點發送請求記錄

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"
}
}

翻譯免責聲明 本文章是為方便客戶閱讀，由自動翻譯軟體自日文原文翻譯而成。儘管我們已盡合理努力確保翻譯的準確性，但由於自動翻譯的特性，文中可能仍包含不準確的表述或誤譯。我們不保證本翻譯的準確性、可靠性或完整性。 若對翻譯文章的內容有任何疑問或歧義，請以官方發布的日文原版文章為準。