レート制限

各アカウントは60秒のウィンドウあたり30回、リンク作成を呼び出せます。この枠はRESTのPOST /api/v1/links、POST /api/v1/uploads、POST /api/v1/sheetsとMCPのcreate_linksで共有されます。アップロード予約とシート送信はそれぞれ1回を消費し、配下のリンク変換は消費しません。即時リクエストも一括処理の送信も、含まれる入力数にかかわらず1回として数えます。

受け付けた作成リクエストとレート制限による拒否には、構造化ヘッダーが含まれます。

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

qは利用枠、wはウィンドウの秒数です。rは残りの呼び出し回数、tは1回分の空きができるまでの秒数です。これらは単なる数値ではなく、構造化フィールドです。

利用枠を使い切ると、rate-limited問題と秒数のRetry-Afterを含む429が返ります。待ってから再試行し、同じアカウントを使うクライアント間で呼び出しを調整してください。ジョブの読み取りはこのリンク作成枠を消費しません。ジョブのpoll_after_secondsとRetry-Afterの指示に従ってください。

検索枠セクションのリンクをコピー

キーワード検索には、アカウントごとに60秒あたり30回の独立した枠があります。検索の受け付けはリンク作成枠を消費しません。商品、ショップ、シート、非対応リンクとして解決された貼り付け内容はキーワード検索をスキップし、どちらの枠も消費しません。読み取れない貼り付け内容はキーワード検索に進む場合があります。

キーワード検索の受け付け判定まで進んだ成功レスポンスと、検索レート制限による拒否レスポンスには、次のヘッダーが含まれます。

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

検索の拒否はsearch-rate-limitedとRetry-After付きの429を返します。各ヘッダーフィールドの意味は上記と同じです。Idempotency-Keyで作成リクエストを再返却する際は新たなリンク作成枠を消費しません。429は再返却用に保存されません。