APIのレート制限について

【レート制限とは】

APIの過剰な呼び出しを防ぐために設定されている、呼び出し回数の上限です。

【WorkVellのレート制限】

レート制限はAPIキーごとに設定します（既定は1分あたり120リクエスト）。

プランによって一律に決まるものではありません。上限の変更をご希望の場合はサポートまでお問い合わせください。

なお、APIキーには接続元IPアドレスの許可リスト・スコープ・有効期限も設定できます（#GEN-044 参照）。

【レート制限に達した場合】

HTTP 429 Too Many Requests が返ります。

しばらく間隔を空けてから再試行してください。

【対処のベストプラクティス】

① バックオフ（再試行の間隔を段階的に広げる）

② バッチ処理（データを一括で取得・更新する）

③ APIレスポンスのキャッシュ（頻繁に変わらないデータは再取得しない）

【使用量の確認】

管理画面にAPIの使用状況を確認する画面はありません。

利用状況の確認が必要な場合はサポートまでお問い合わせください。

【APIキーの発行】

管理画面からAPIキーを発行することはできません。発行のご依頼はサポートまでお願いします（#GEN-008 参照）。