メインコンテンツへスキップ

レスポンス形式

一般的なエラーレスポンスには、success、code、errorが含まれます。
一部のエンドポイントでは、エラーの詳細だけを返します。
リクエストが成功し、成功フラグが返る場合の例です。
エンドポイントによっては、dataとerrorを返します。

HTTPステータスコード

エラーレスポンスの例

400 リクエストが不正な場合

401 認証に失敗した場合

413 リクエストが大きすぎる場合

500 サーバーでエラーが発生した場合

エラーへの対処

  • トークンの期限が切れている場合は、POST /authenticateで再発行してから再送します。
  • 1回のリクエストで処理できる件数を超える場合は、データを分割します。たとえば、一部の操作では1回あたり1,000件まで送信できます。
  • 429や一部の500など、再試行できるエラーには指数バックオフを使用します。