レート制限
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 ヘッダーには再試行までの秒数が入ります。
Retry-After の秒数を待つ
Retry-After の秒数が経つまで、同じ API を呼ばないでください。
同じ要求を再送する
POST で Idempotency-Key を使っている要求は、同じキーで再送します。キーは作り直さないでください。
呼び出しの頻度を減らす
同じ上限に繰り返し当たるときは、呼び出しの間隔を広げるか、結果を再利用します。
呼び出し回数を減らす
- 機能フラグの照会で付与されている結果だけを、同じお客様について最大60秒キャッシュしてかまいません。ほぼすべてのリクエストで照会するアプリは、キャッシュを使うと枠の消費を抑えられます。
- 購入直後は、権利が反映されるまで数秒かかることがあります。お客様が購入完了ページに戻った直後に照会して見つからなければ、数秒おきに数回だけ照会し直してください。Cozeni の側で待つ仕組みはありません。
エラーの形式と再試行の詳細は、エラー を参照してください。