レート制限

レート制限はAPIの乱用を防ぎ、すべての顧客間での公平な使用を保証します。制限はプランによって異なります。

プランごとの制限

すべてのAPIレスポンスには、ヘッダーにレート制限情報が含まれています。

レート制限を超えると、APIは 429 Too Many Requestsレスポンスを返します。これを適切に処理するには：

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}

プラン

リクエスト/分

クレジット/月

無料

1,000

従量課金

購入に基づく

プロジェクト

7,000

ブートストラップ

28,000

スタートアップ

85,000

グロース

200,000

レート制限ヘッダー

すべてのAPIレスポンスには、ヘッダーにレート制限情報が含まれています。

ヘッダー

説明

X-RateLimit-Limit

プランごとの1分間の最大リクエスト数

X-RateLimit-Remaining

現在のウィンドウ内の残りリクエスト数

X-RateLimit-Reset

レート制限がリセットされるUnixタイムスタンプ

429エラーの処理

レート制限を超えると、APIは 429 Too Many Requestsレスポンスを返します。これを適切に処理するには：

再試行可能な時間をX-RateLimit-Resetヘッダーで確認する

リトライロジックに指数バックオフを実装する

1分あたりの制限内に収めるためにリクエストをキューイングする

一貫して制限に達する場合はプランのアップグレードを検討する

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}