Skip to main content
啟潤支付使用標準 HTTP 狀態碼來表示 API 請求的成功或失敗。

HTTP 狀態碼

錯誤回應格式

發生錯誤時,回應本體包含以下 JSON 結構:
error 物件僅在驗證錯誤(400)時出現。其他錯誤類型只包含 codemessage

常見錯誤

400 錯誤請求

請求本體或參數無效時返回。

401 未認證

API 密鑰缺失或無效時返回。

404 未找到

請求的資源不存在時返回。

429 請求過多

超過 API 頻率限制(每分鐘 100 次請求)時返回。
在你的整合中實現指數退避策略,以優雅地處理頻率限制。

成功回應格式

成功的回應始終包含 code: 0message: "success"
對於分頁介面,data 欄位包含 itemspagination