> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# レート制限

> API は公平な使用とシステムの安定性を確保するためにレート制限を実装しています。エンドポイントによって制限は異なりますが、以下のガイドラインに従ってください:

## レート制限の概要

* ポーリング操作 (リクエストステータスの確認) では、リクエスト間に少なくとも 1 秒の間隔を設けてください
* レート制限の応答が発生した場合は、指数バックオフを実装してください
* レート制限情報を監視するためにレスポンスヘッダーを確認してください

## レート制限ヘッダー

API は、レート制限に関する情報を提供するために以下のヘッダーを返します。

| ヘッダー                    | 説明                                 |
| ----------------------- | ---------------------------------- |
| `X-RateLimit-Limit`     | 一定期間内の最大リクエスト数                     |
| `X-RateLimit-Remaining` | 現在の期間に残っているリクエスト数                  |
| `X-RateLimit-Reset`     | 現在のレート制限ウィンドウがリセットされる Unix タイムスタンプ |

## レート制限超過時の応答

レート制限を超えると、HTTP 429 Too Many Requests レスポンスが返されます。

```json theme={null}
{
  "statusCode": 429,
  "errorId": "rate_limit_exceeded",
  "message": "Too Many Requests"
}
```

## レート制限超過時の対処方法

1. レスポンスヘッダーの `Retry-After` 値を使用して、再試行時間を決定します
2. 指数バックオフアルゴリズムを実装して、再試行間隔を徐々に増加させます
3. レート制限が繰り返し発生する場合は、API の使用方法を見直してください

## ベストプラクティス

* API クライアントにレート制限ハンドリングを実装する
* レート制限に近づいた場合は、リクエスト頻度を調整する
* 重要な操作には、レート制限を考慮したリトライロジックを実装する