エラーハンドリング

すべてのエラーは error フィールドを含む JSON オブジェクトを返します：

{
  "error": "not enough storage, please upgrade your plan"
}

ステータスコード

コード	意味	よくある原因
400	Bad Request	パラメータの不足または無効、サポートされていないコンテンツタイプ、無効な JSON ボディ。
401	Unauthorized	API キーの不足または無効。
402	Payment Required	ストレージ制限超過 — プランをアップグレードするか、月次リセットをお待ちください。
404	Not Found	ファイル CID またはユーザーが見つかりません。
429	Too Many Requests	ゲートウェイ帯域幅制限超過 — 月次リセットをお待ちください。
500	Internal Error	予期しないサーバーエラー — リトライするかサポートにお問い合わせください。

4xx クライアントエラー

4xx コードはリクエスト自体に問題があることを示します。API キーが有効か（401）、リクエストボディが正しい形式の JSON か（400）、ストレージクォータを超えていないか（402）を確認してください。.car アーカイブを使った一括アップロードについては、CAR インポートガイドで対応フォーマットを確認できます。

5xx サーバーエラー

500 レスポンスはサーバー側で予期しない状態が発生したことを意味します。少し時間を置いてリクエストを再試行してください。エラーが続く場合は、レスポンスヘッダーのリクエスト ID を添えてサポートにお問い合わせください。