レート制限とサイズ制限

プラットフォームの安定性を保つために、API にはリクエスト頻度とデータサイズの制限があります。

リクエスト頻度

許容されるリクエスト頻度を超えると、サーバーは 429 Too Many Requests を返します。適切な対応は指数バックオフによる再試行です。再試行間隔を徐々に延ばし、連続したリクエストを送り続けないようにしてください。大量操作は時間をかけて分散させ、並列バーストではなく1つのトークンを順番に使用してください。

リクエストボディのサイズ

通常の REST リクエストの場合、JSON ボディのサイズは 2 MiB に制限されています。これはリアクション、コレクション、設定のあらゆる構成に十分なサイズです。ボディがそれより大きい場合は、操作を分割してください（例: リアクションをバッチでインポートする）。

インポート時のボディサイズ

インポートエンドポイントは大きなバンドルを想定しており、個別の上位制限があります。データインポートは 64 MiB まで、メディアを含むインポートは 256 MiB までです。バンドルがそれを超える場合は、複数のインポートに分割してください。

制限を超えた場合

  • 頻度制限を超えた場合 — 429、遅延をおいて再試行。
  • ボディが許容サイズを超えた場合 — リクエストは拒否されます（エンドポイントに応じて 413 または 400）。ペイロードを小さくするか分割してください。

次のステップ