エラーコードとトラブルシューティング

エラー応答フォーマット

1 {
2   "code": 1003,
3   "message": "Invalid token",
4   "requestId": "req-12345678"
5 }

ビジネスエラーは通常、統一された JSON 構造を返します。インテグレーターはまずその code を確認するべきです。認証失敗は HTTP 401を返すことがあります;レート制限は HTTP 429を返すことがあります。

問題	推奨事項
有効な認証情報がない`1001`	`Authorization: Bearer <accessToken>`か`X-API-KEY`が含まれているかを確認してください。
`1002` トークンの期限切れ	再試す前にトークンをリフレッシュするか、再度ログインしてください。
`1003` 無効なトークン、 API Key、または署名	API Key、署名ペイロード、リクエストボディのJSON文字列、クエリパラメータの順序をチェックします。
`1006` 源 IP 不一致	API Key IPホワイトリストの設定を確認してください。
`3004` 重複リクエスト	順序に関連するパスで同じ署名を再利用しないでください。 `timestamp` と `signature`を再生成してください。
`5003` 金利制限が発動しました	リクエスト頻度を減らし、再試行する場合は指数的バックオフを使いましょう。
`Timestamp outside of tolerance window`	`/v1/time`に電話して時間オフセットのキャリブレーションを行い、再度リクエストに署名してください。