レート制限 - Admina Help Center

レート制限の概要

ポーリング操作 (リクエストステータスの確認) では、リクエスト間に少なくとも 1 秒の間隔を設けてください
レート制限の応答が発生した場合は、指数バックオフを実装してください
レート制限情報を監視するためにレスポンスヘッダーを確認してください

レート制限ヘッダー

API は、レート制限に関する情報を提供するために以下のヘッダーを返します。

ヘッダー	説明
`X-RateLimit-Limit`	一定期間内の最大リクエスト数
`X-RateLimit-Remaining`	現在の期間に残っているリクエスト数
`X-RateLimit-Reset`	現在のレート制限ウィンドウがリセットされる Unix タイムスタンプ

レート制限超過時の応答

レート制限を超えると、HTTP 429 Too Many Requests レスポンスが返されます。

{
  "statusCode": 429,
  "errorId": "rate_limit_exceeded",
  "message": "Too Many Requests"
}

レート制限超過時の対処方法

レスポンスヘッダーの Retry-After 値を使用して、再試行時間を決定します
指数バックオフアルゴリズムを実装して、再試行間隔を徐々に増加させます
レート制限が繰り返し発生する場合は、API の使用方法を見直してください

ベストプラクティス

API クライアントにレート制限ハンドリングを実装する
レート制限に近づいた場合は、リクエスト頻度を調整する
重要な操作には、レート制限を考慮したリトライロジックを実装する

最終更新日 2026年6月24日

エラーサポート