レート制限の方針
AI Helpdesk API は HTTP レイヤでのレート制限を現在は実施していません。X-RateLimit-* ヘッダや 429 Too Many Requests を返すこともありません。
ただし上流のデータストア（DynamoDB）はキャパシティが有限です。大量リクエストを送ると上流のスロットリングや遅延を招く可能性があります。1 つの API キーあたり概ね ~20 RPS 以下に保つ ことを目安にしてください。
推奨運用
- バルク取得する場合は、リクエスト間に十分な間隔（最低 50ms）を空ける
- 並列処理を行う場合も、同時実行数を抑える（1 キーあたり 5〜10 並列程度を目安）
- 上流のスロットリングを示唆するレスポンス遅延が観測された場合は、指数バックオフでリトライ間隔を伸ばす
- 短時間に何度も同じデータを取得しているコードがあれば、クライアント側でキャッシュする
ポーリングを行う場合
セッション一覧や通知のポーリングを行う場合は、用途に応じた最小限の頻度に抑えてください。| 用途 | 推奨ポーリング間隔 |
|---|---|
| 未対応セッション数の表示 | 30 秒以上 |
| 通知バッジの更新 | 30 秒以上 |
| 通常のダッシュボード再描画 | 60 秒以上 |