レート制限

Sofia API は、15 分、24 時間、30 日の 3 つのウィンドウでリクエストを数えます。

トークン	15 分	24 時間	30 日
個人キー（アカウントごと）	150	1,000	10,000
OAuth クライアント	100	500	15,000
OAuth クライアント、認可したユーザーごと（最大 1,000）	+10	+25	+100

ヘッダー

すべての応答で、残りの量が IETF の形式で示されます。

http

RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000

r は残りのリクエスト数、t はウィンドウがリセットされるまでの秒数、q はクォータ、w はウィンドウの長さ（秒）です。

ウィンドウが上限に達したとき

応答は 429 rate_limit_exceeded で、Retry-After ヘッダーと、使い切ったウィンドウが details に含まれます。その時間だけ待ってから再試行してください。

API を効率よく使うには

投稿をポーリングする代わりに、webhook を登録してください。
limit を最大 100 にして、少ないページ数で一覧を取得してください。
変更の少ないデータ（プラットフォーム、店舗、連携済みアカウント）はキャッシュしてください。