> ## Documentation Index
> Fetch the complete documentation index at: https://help.comdesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# レート制限と容量

> テナント単位のレート制限、日次・月次容量、429 レスポンス、正しいバックオフ方法。

レート制限はキー単位ではなく**テナント単位**で適用されます。テナントに属するすべてのキーが同じ枠を共有します。制限は Redis ベースのスライディングウィンドウで管理されます。

## レート制限

| 区分    | 上限                    | 備考                      |
| ----- | --------------------- | ----------------------- |
| デフォルト | **300 リクエスト / 分**     | テナント単位                  |
| バースト  | **600 リクエスト / 分**     | 最大 10 秒間                |
| カスタム  | エンドポイント × テナント単位で設定可能 | `open_api_advanced` が必要 |

## 容量

| 容量         | Free             | Pro                | Max                 | 範囲                          |
| ---------- | ---------------- | ------------------ | ------------------- | --------------------------- |
| 日次リクエスト    | **1,000 / 日**    | **10,000 / 日**     | **100,000 / 日**     | テナント単位                      |
| 月次リクエスト    | **20,000 / 月**   | **200,000 / 月**    | **2,000,000 / 月**   | テナント単位                      |
| Webhook 配信 | **500 イベント / 月** | **5,000 イベント / 月** | **50,000 イベント / 月** | テナント単位（`open_api_advanced`） |

## レート制限ヘッダー

すべての v1 レスポンスに含まれます：

| ヘッダー                    | 意味                         |
| ----------------------- | -------------------------- |
| `X-RateLimit-Limit`     | 1 分あたりの許可リクエスト数（例：`300`）   |
| `X-RateLimit-Remaining` | 現在のウィンドウの残りリクエスト数          |
| `X-RateLimit-Reset`     | ウィンドウがリセットされる Unix タイムスタンプ |

## 上限を超えたとき

`Retry-After` ヘッダー（待機秒数）付きで `429` を受け取ります：

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1717315200
```

```json theme={null}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "retry_after": 30
  }
}
```

日次・月次クォータを使い切った場合は、代わりに `429 quota_exceeded` を受け取ります。クォータのウィンドウがリセットされるのを待つか、Comdesk に上限引き上げを依頼してください。

<Warning>
  `429` を受け取ったら、`Retry-After` の秒数だけ待ってから再試行してください。タイトなループでの再試行は**避けてください** — スロットルを悪化させるだけです。ジッター付きの指数バックオフを使いましょう。
</Warning>

## ライセンスプラン

| 機能                |  `open_api`  | `open_api_advanced` |
| ----------------- | :----------: | :-----------------: |
| クリックして発信          |       ✅      |          ✅          |
| 通話履歴（読み取り）        |       ✅      |          ✅          |
| 顧客管理              |       ✅      |          ✅          |
| デフォルトレート制限（300/分） |       ✅      |          ✅          |
| アウトバウンド Webhook   |       —      |          ✅          |
| レポート API          |       —      |          ✅          |
| テナント別カスタムレート制限    |       —      |          ✅          |
| IVR トリガー          |       —      |          ✅          |
| 日次容量              |  1,000 req/日 |         カスタム        |
| 月次容量              | 20,000 req/月 |         カスタム        |
| Webhook 配信        |       —      |    50,000 イベント/月    |