コンテンツにスキップ
Docs
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

レート制限

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 の側で待つ仕組みはありません。

エラーの形式と再試行の詳細は、エラー を参照してください。

このページは役に立ちましたか?