Reference

API のリクエスト回数制限

KARTEのサーバーサイドAPIは費用体系に応じて以下のリクエスト制限を設けています。

  • 分間リクエスト数の制限
    • API Endpoint毎にリクエスト数を制限します。

分間リクエスト制限

KARTE のサーバーサイド API は API Endpoint 毎に分間リクエスト制限を設けています。
各エンドポイントのリクエスト制限に関しては以下の表（無償枠）でご確認ください。

もし、API v2のFreePlanの枠以上にリクエストをご検討されている場合は、営業担当までお問い合わせください。

Account

MethodEndpointFree PlanGrowthEnterprise
POST/v2/account/list5回 / 分30回 / 分応相談
POST/v2beta/account/create10回 / 分30回 / 分応相談
POST/v2beta/account/delete10回 / 分30回 / 分応相談

Action

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/action/action/create10回 / 分30回 / 分応相談
POST/v2beta/action/action/findById10回 / 分30回 / 分応相談
POST/v2beta/action/action/update10回 / 分30回 / 分応相談

Action Table

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/action/actionTable/records/delete10回 / 分30回 / 分応相談
POST/v2beta/action/actionTable/records/upsert10回 / 分30回 / 分応相談

Campaign

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/action/campaign/create10回 / 分30回 / 分応相談
POST/v2beta/action/campaign/findById10回 / 分30回 / 分応相談
POST/v2beta/action/campaign/getSettingsAndStats10回 / 分10回 / 分応相談
POST/v2beta/action/campaign/toggleEnabled10回 / 分30回 / 分応相談
POST/v2beta/action/campaign/update10回 / 分30回 / 分応相談

Craft Function

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/craft/function/code/findByVersion20回 / 分50回 / 分応相談
POST/v2beta/craft/function/create10回 / 分30回 / 分応相談
POST/v2beta/craft/function/delete10回 / 分30回 / 分応相談
POST/v2beta/craft/function/metadata/findById20回 / 分50回 / 分応相談
POST/v2beta/craft/function/metadata/findByName20回 / 分50回 / 分応相談
POST/v2beta/craft/function/update10回 / 分30回 / 分応相談

Craft Sites

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/craft/sites/content/file/remove100回 / 分応相談応相談
POST/v2beta/craft/sites/content/directory/remove100回 / 分応相談応相談
POST/v2beta/craft/sites/content/get100回 / 分応相談応相談
POST/v2beta/craft/sites/content/invalidate1回 / 分応相談応相談
POST/v2beta/craft/sites/content/remove100回 / 分応相談応相談
POST/v2beta/craft/sites/content/setMetaData100回 / 分応相談応相談
POST/v2beta/craft/sites/content/updateVisibilityByDirectory100回 / 分応相談応相談
POST/v2beta/craft/sites/content/updateVisibility100回 / 分応相談応相談
POST/v2beta/craft/sites/content/upload100回 / 分応相談応相談
POST/v2beta/craft/sites/file/upload100回 / 分応相談応相談

Datahub Jobflow

MethodEndpointFree PlanGrowthEnterprise
POST/v2/datahub/jobflow/exec10回 / 分30回 / 分応相談
POST/v2/datahub/jobflow/get10回 / 分50回 / 分応相談

Operation Status

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/operation/status/get6000回 / 分6000回 / 分応相談

Role

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/project/role/create10回 / 分30回 / 分応相談
POST/v2beta/project/role/delete10回 / 分30回 / 分応相談
POST/v2beta/project/role/list10回 / 分50回 / 分応相談

Talk Assignee

MethodEndpointFree PlanGrowthEnterprise
POST/v2/talk/assignee/assign10回 / 分30回 / 分応相談
POST/v2/talk/assignee/unassign10回 / 分30回 / 分応相談
POST/v2beta/talk/assignee/get10回 / 分30回 / 分応相談

Talk Message

MethodEndpointFree PlanGrowthEnterprise
POST/v2/talk/message/get20回 / 分100回 / 分応相談
POST/v2/talk/message/sendFromOperator20回 / 分30回 / 分応相談
POST/v2/talk/message/sendFromUser20回 / 分30回 / 分応相談

Talk Note

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/talk/note/get10回 / 分30回 / 分応相談
POST/v2beta/talk/note/send20回 / 分30回 / 分応相談

Talk Operator

MethodEndpointFree PlanGrowthEnterprise
POST/v2/talk/operator/get10回 / 分30回 / 分応相談
POST/v2beta/talk/operator/list10回 / 分30回 / 分応相談

Talk Status

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/talk/status/change10回 / 分30回 / 分応相談

Track Event

MethodEndpointFree PlanGrowthEnterprise
POST/v2/track/event/write200回 / 分1000回 / 分応相談
POST/v2beta/track/event/get10回 / 分50回 / 分応相談
POST/v2beta/track/event/writeAndExecAction100回 / 分500回 / 分応相談

Track RefTable

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/track/refTable/row/delete10回 / 分30回 / 分応相談
POST/v2beta/track/refTable/row/upsert10回 / 分30回 / 分応相談

Track User

MethodEndpointFree PlanGrowthEnterprise
POST/v2beta/track/user/get100回 / 分100回 / 分応相談

分間制限を超えてリクエストを送信した場合

制限を超えてリクエストを送信した場合、APIは処理を実行せず、次のエラーを返却します。

429 Too Many Request

よくある質問

Q. 同一プロジェクトの複数のアプリから同一API Endpointを利用した場合、リクエスト数のカウントは「アプリ毎」と「プロジェクト毎」のどちらで行われますか？

リクエスト回数制限のチェックで使われるリクエスト数のカウントは、あくまでも「プロジェクト×API Endpoint」単位で計算されます。つまり、同一プロジェクトで複数のアプリを作ったとしても、リクエスト数のカウントはプロジェクト単位で合算されます

Q. 分間のリクエスト回数制限に抵触した場合、どのタイミングで制限が解除されますか？

2023年11月現在、APIレート制限は「スライディングウィンドウ方式」で実装されています。つまり、リクエストを受信する度に「直近1分間のリクエスト回数の合計」が上限値を超えていないかチェックされ、超えている場合はエラーになります。