レート制限

Annie Insights API は、公正な使用とシステムの安定性を確保するためにレート制限を強制します。

キーの種類による制限

キーの種類	レート制限	バースト	デイリーキャップ
サンドボックス	10 要求/分	5 同時	500/日
生産	カスタム	カスタム	カスタム

レート制限ヘッダー

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

ヘッダ	説明
X-RateLimit-Limit	現在のウィンドウで許可される最大リクエスト数
X-RateLimit-Remaining	現在のウィンドウに残っているリクエスト
X-RateLimit-Reset	ウィンドウがリセットされたときの Unix タイムスタンプ
Retry-After	再試行するまでに待機する秒数 (429 のみ)

レート制限の処理

レート制限を超えると、API は HTTP 429 を返します。

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Retry after 60 seconds.",
  "statusCode": 429
}

ベストプラクティス

1. ヘッダーの監視 — リクエストを送信する前に X-RateLimit-Remaining を確認してください
2. リクエストのキュー — スループットを制御したリクエスト キューを実装します。
3. 指数関数的バックオフ — 429 では、再試行する前に 2^attempt 秒待機します
4. 営業にお問い合わせください — 上限を超える場合は、api-support@hcds.ai にお問い合わせください。