---
title: レート制限
description: API の種類ごとの呼び出し回数の上限と、超えたときの対応。
---

API には1分あたりの呼び出し回数の上限があります。上限は IP アドレス、API キー、販売者のそれぞれで数えられ、どれか1つでも超えると `429 rate_limited` が返ります。API の種類ごとに、別々の枠で数えます。

## 上限の一覧

| API | IP アドレス | API キー | 販売者 |
| --- | --- | --- | --- |
| 管理 API（アカウント、商品、購入リンク、画像、購入画面の作成、テスト購入） | 120回/分 | 60回/分 | 300回/分 |
| 機能フラグの照会（`POST /customers/state`） | 600回/分 | 600回/分 | 3,000回/分 |
| CLI のコード発行（`POST /cli/device-codes`） | 10回/分 | — | — |
| CLI のログイン確認とログアウト（`POST /cli/tokens`、`POST /cli/logout`） | 120回/分 | — | — |

- 購入画面の作成（`POST /checkout/sessions`）は、管理 API の枠を使います。照会の枠は使いません。
- 機能フラグの照会は管理 API の枠を使いません。
- CLI の枠は IP アドレスだけで数えます。
- テスト購入（サンドボックス専用）は管理 API の枠を使います。
- この表にない API（権利確認、ハンドオフ、ポータルへのリンク）の上限は、ここでは示していません。
- 表の値は現在の設定です。サンドボックスの上限も本番と同じです。
- 上限は地域ごとの近似で数えます。世界全体で厳密に合計した値ではありません。

## 上限を超えたとき

上限を超えると、`429 rate_limited` が返ります。応答の `Retry-After` ヘッダーには再試行までの秒数が入ります。

1. **Retry-After の秒数を待つ**

    `Retry-After` の秒数が経つまで、同じ API を呼ばないでください。

2. **同じ要求を再送する**

    `POST` で `Idempotency-Key` を使っている要求は、同じキーで再送します。キーは作り直さないでください。

3. **呼び出しの頻度を減らす**

    同じ上限に繰り返し当たるときは、呼び出しの間隔を広げるか、結果を再利用します。

## 呼び出し回数を減らす

- 機能フラグの照会で付与されている結果だけを、同じお客様について最大60秒キャッシュしてかまいません。ほぼすべてのリクエストで照会するアプリは、キャッシュを使うと枠の消費を抑えられます。
- 購入直後は、権利が反映されるまで数秒かかることがあります。お客様が購入完了ページに戻った直後に照会して見つからなければ、数秒おきに数回だけ照会し直してください。Cozeni の側で待つ仕組みはありません。

エラーの形式と再試行の詳細は、[エラー](/api-reference/errors) を参照してください。
