API リファレンス

エラー処理

標準エラーコード、レート制限ヘッダー、トラブルシューティング。

最終更新： 2026年5月28日

エラーハンドリング

すべてのエラーレスポンスは、エラーコードと人間が読めるメッセージを含む一貫したフォーマットに従います：

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Description of what went wrong"
  }
}

HTTP Status	Code	Description
400	VALIDATION_ERROR	無効または欠落したリクエストパラメータ
401	UNAUTHORIZED	API キーが欠落または無効です
402	PAYMENT_REQUIRED	クレジットが不足しています
403	FORBIDDEN	API アクセスには Business プランが必要、またはアクションが許可されていません
403	LIMIT_EXCEEDED	プランの制限に達しました（プロジェクト、ビルドなど）
404	NOT_FOUND	リソースが見つからないかアクセスできません
409	CONFLICT	リソースの競合（デプロイ進行中、ドメインが使用中など）
429	RATE_LIMITED	リクエストが多すぎます — レート制限ヘッダーを確認してください
500	INTERNAL_ERROR	サーバーエラー — リトライするかサポートにお問い合わせください

すべてのレスポンスにはこれらのヘッダーが含まれます：

429 レスポンスを受け取った場合、リトライする前に X-RateLimit-Reset で示された秒数だけ待機してください。

クレジットを消費する API アクション：

管理者はクレジット請求から免除されます。