錯誤代碼與故障排除

錯誤回應格式

{
  "code": 1003,
  "message": "Invalid token",
  "requestId": "req-12345678"
}

商業錯誤通常仍會回傳統一的 JSON 結構。整合商應該先檢查 code 。認證失敗可能會返回 HTTP 401;速率限制可能會回歸 HTTP 429。

問題	推薦
`1001` 沒有有效的認證資訊	請確認是否包含 `Authorization: Bearer <accessToken>` 或 `X-API-KEY` 。
`1002` 代幣已過期	重新嘗試前請重新整理 Token 或重新登入。
`1003` 無效的 Token、 API Key或 Signature	檢查 API Key、簽章有效載入、請求主體 JSON 字串，以及查詢參數順序。
`1006` 來源 IP 不匹配	檢查 API Key IP 白名單設定。
`3004` 重複請求	不要重複使用相同的簽名作為與順序相關的路徑。再生 `timestamp` 並 `signature`。
`5003` 費率上限已觸發	減少請求頻率，重試時使用指數退讓。
`Timestamp outside of tolerance window`	打電話給 `/v1/time` 校準時間偏移，並再次簽署申請。