レート制限

API は、ご利用プランのティアに基づいて秒間リクエスト数のレート制限を適用します。

プラン別の制限

プラン	秒間リクエスト数
Starter	50
Professional	100
Enterprise	500
Custom	個別相談

レスポンスヘッダー

すべての API レスポンスにレート制限の情報が含まれます：

ヘッダー	説明
X-RateLimit-Limit	ご利用プランの秒間最大リクエスト数
X-RateLimit-Remaining	現在のウィンドウ内の残りリクエスト数
X-RateLimit-Reset	現在のウィンドウがリセットされる Unix タイムスタンプ
Retry-After	リトライまでの待機秒数（429 の場合のみ）

レート制限への対応

制限を超過すると、API は 429 Too Many Requests を返します：

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Try again in 1 second.",
  "instance": "/v1/feed"
}

推奨されるアプローチ：

1. リクエスト前に X-RateLimit-Remaining を確認してください。
2. 429 を受け取った場合は、Retry-After で指定された時間だけ待機してください。
3. リトライロジックには Exponential Backoff を実装してください。

ベストプラクティス

• レスポンスをキャッシュする — API コールの回数を削減できます。
• イベントをバッチ送信する — POST /v1/events リクエストで最大 100 件のイベントを一括送信してください。
• リクエストを均等に分散する — バースト的な送信を避けてください。
• より高い制限が必要な場合は、お問い合わせください。