レート制限
Engine ≥ 4.143.0. トークンの各応答には、発行時の店舗ポリシーに基づく data.rate_limits が含まれます。すべてのキーで上限を共有し、新しいトークンでもリセットされません。プラン変更はトークンの有効期限前に適用される場合があります。
- read_per_minute
- 1分あたりの読み取りリクエスト数。
- write_per_minute
- 1分あたりの書き込みリクエスト数。この値は書き込み権限を付与しません。
- auth_per_minute
- 認証失敗を含む、1分あたりのトークンリクエスト数。
リクエストを均等に送信してください。読み取り上限が正の場合、読み取り間隔を少なくとも 60 / read_per_minute 秒にします。この上限は同数の同時リクエストを保証しません。他の連携も共有するため、429 と Retry-After に対応してください。
0 は無制限ではなく、利用できないことを示します。
1 分あたりの上限
| 利用可能な最低プラン | 読み取り · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- 書き込み
- 10
- 認証
- 10
同じストアのすべてのキーでこれらの上限を共有します。
リクエスト
- 読み取りと書き込みには、ストアの現在の API ポリシーが適用されます。
- キーごとに独立した無制限の処理能力が得られるわけではありません。
- 同時実行を制限し、適切な参照データをキャッシュし、変わっていない詳細レコードを何度も取得しないでください。
429 · Retry-After
- 429 と rate_limit.exceeded が返された場合は、Retry-After の秒数以上待ち、ランダムな遅延を加えて再試行します。
- 429 · capacity.queue_full — APIの短い待機キューが満杯です。リクエストの実行は開始されていません。 429 · capacity.wait_timeout — APIキューの待機時間が終了しました。リクエストの実行は開始されていません。 Retry-After の秒数以上待ち、ランダムな遅延を加えます。書き込みの再試行では元のキーと内容を維持します。
- 固定の再試行間隔を推測せず、文書化されたコードとヘッダーに従ってください。