調用開放介面報錯時，先看返回的錯誤碼：鑑權、參數與限流是最常見的三類原因。多數問題無需提工單即可自行解決。
鑑權類錯誤
檢查密鑰是否正確、是否過期，以及請求簽章的時間戳與算法是否匹配。
- 確認使用正確的密鑰
- 檢查簽章算法與時間戳
- 確認介面權限範圍
參數類錯誤
核對必填字段、字段類型與枚舉值，分頁參數超出範圍也會返回錯誤。
- 核對必填字段
- 檢查字段類型與枚舉
- 分頁大小不超過上限
限流與重試
觸發限流時應按指數退避重試，避免短時間大量重發導致持續失敗。
- 按指數退避重試
- 錯峰批次任務
- 在控制台查看用量
常見問題
返回簽章錯誤但密鑰正確？
多為時間戳偏差或參數排序不一致，請對照檔案重新生成簽章。
Webhook 收不到事件？
檢查回調位址是否可公網訪問、是否校驗簽章失敗，並查看失敗重試日誌。