API のリクエスト回数制限

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

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

分間リクエスト制限

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

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

MethodEndpointFree PlanGrowthEnterprise
POST/v2/track/event/write200回 / 分1000回 / 分応相談
POST/v2beta/track/event/writeAndExecAction100回 / 分500回 / 分応相談
POST/v2beta/track/event/get10回 / 分50回 / 分応相談
POST/v2beta/track/refTable/row/upsert10回 / 分30回 / 分応相談
POST/v2beta/track/refTable/row/delete10回 / 分30回 / 分応相談
POST/v2beta/track/user/get10回 / 分50回 / 分応相談
POST/v2beta/action/actionTable/records/upsert10回 / 分30回 / 分応相談
POST/v2beta/action/actionTable/records/delete10回 / 分30回 / 分応相談
POST/v2beta/action/campaign/toggleEnabled10回 / 分30回 / 分応相談
POST/v2/datahub/jobflow/get10回 / 分50回 / 分応相談
POST/v2/datahub/jobflow/exec10回 / 分30回 / 分応相談
POST/v2/talk/message/sendFromOperator20回 / 分30回 / 分応相談
POST/v2/talk/message/sendFromUser20回 / 分30回 / 分応相談
POST/v2/talk/message/get20回 / 分100回 / 分応相談
POST/v2/talk/assignee/assign10回 / 分30回 / 分応相談
POST/v2/talk/assignee/unassign10回 / 分30回 / 分応相談
POST/v2beta/talk/assignee/get10回 / 分30回 / 分応相談
POST/v2/talk/operator/get5回 / 分30回 / 分応相談
POST/v2beta/talk/operator/list5回 / 分30回 / 分応相談
POST/v2beta/talk/status/change10回 / 分30回 / 分応相談
POST/v2beta/talk/note/send20回 / 分30回 / 分応相談
POST/v2beta/rightsupport/contactData/upsert20回 / 分50回 / 分応相談
POST/v2beta/rightsupport/contactData/deleteById10回 / 分30回 / 分応相談
POST/v2beta/operation/status/get6000回 / 分6000回 / 分応相談
POST/v2/account/list5回 / 分50回 / 分応相談
POST/v2beta/account/create10回 / 分30回 / 分応相談
POST/v2beta/account/delete10回 / 分30回 / 分応相談
POST/v2beta/project/role/list10回 / 分50回 / 分応相談
POST/v2beta/project/role/create10回 / 分30回 / 分応相談
POST/v2beta/project/role/delete10回 / 分30回 / 分応相談

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

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

429 Too Many Request 

よくある質問

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

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

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

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