記事

Advanced Commerce API のレート制限の特定

Advanced Commerce API エンドポイントに適用されるレート制限を認識し、対処します。

Advanced Commerce API では、指定された時間内に各エンドポイントに送信できる要求数が制限されています。要求制限はアプリごとに適用されます。以下の表は、製品環境におけるレート制限を 1 秒あたりの要求数で示したものです。制限は 1 時間ごとに適用されます。

エンドポイント	レート制限 (1 秒あたり)
サブスクリプションのキャンセル	5
サブスクリプションのメタデータの変更	50
サブスクリプションの価格の変更	50
サブスクリプションを Advanced Commerce API に移行する	50
取引の払い戻しを要求する	5
サブスクリプションを取り消す	5

サンドボックス環境におけるレート制限は、上記の表の制限の 10% です。Advanced Commerce サーバーは、必要に応じていつでもこれらのレート制限を増減する調整を行う場合があります。

時間あたりの制限を超えた場合、API は要求を拒否し、HTTP 429 応答を返します。応答には RateLimitExceededError が含まれます。API を統合する際は、以下の点にご注意ください。

API を定期的に呼び出す場合は、エンドポイントの 1 時間あたりの制限を超えないようにあなたの要求を制限してください。

エラー処理プロセスで HTTP 429 RateLimitExceededError を管理します。たとえば、失敗をログに記録し、ジョブをキューに入れて後で再処理します。

HTTP 429 エラーが発生した場合は、Retry-After ヘッダーを確認してください。このヘッダーには、次に要求を送信できるタイミングを示す UNIX 時間（ミリ秒単位）が含まれています。

あなたのサーバーからの Advanced Commerce 要求を承認するための JSON Web Token（JWT）を作成します。

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ

トップへ