API のリクエスト回数制限

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

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

月間リクエスト制限

サーバーサイドAPIの月間リクエスト数制限は以下の通りです。

FreePlanStandardPremium
100,000回 / 月500,000回 / 月1,000,000回 / 月

分間リクエスト制限

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

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

MethodEndpointFreePlanStandardPremium
POST/v2/track/event/write200回 / 分500回 / 分1000回 / 分
POST/v2beta/track/event/writeAndExecAction100回 / 分250回 / 分500回 / 分
POST/v2beta/track/event/get10回 / 分25回 / 分50回 / 分
POST/v2beta/track/refTable/row/upsert10回 / 分15回 / 分30回 / 分
POST/v2beta/track/refTable/row/delete10回 / 分15回 / 分30回 / 分
POST/v2beta/track/user/get10回 / 分25回 / 分50回 / 分
POST/v2beta/action/actionTable/records/upsert10回 / 分15回 / 分30回 / 分
POST/v2beta/action/actionTable/records/delete10回 / 分15回 / 分30回 / 分
POST/v2beta/action/campaign/toggleEnabled10回 / 分15回 / 分30回 / 分
POST/v2/datahub/jobflow/get10回 / 分25回 / 分50回 / 分
POST/v2/datahub/jobflow/exec10回 / 分15回 / 分30回 / 分
POST/v2/talk/message/sendFromOperator20回 / 分 ※120回 / 分 ※130回 / 分 ※1
POST/v2/talk/message/sendFromUser20回 / 分 ※120回 / 分 ※130回 / 分 ※1
POST/v2/talk/message/get10回 / 分15回 / 分30回 / 分
POST/v2/talk/assignee/assign10回 / 分15回 / 分30回 / 分
POST/v2/talk/assignee/unassign10回 / 分15回 / 分30回 / 分
POST/v2beta/talk/assignee/get10回 / 分15回 / 分30回 / 分
POST/v2/talk/operator/get5回 / 分15回 / 分30回 / 分
POST/v2beta/talk/operator/list5回 / 分15回 / 分30回 / 分
POST/v2beta/talk/status/change10回 / 分15回 / 分30回 / 分
POST/v2beta/talk/note/send20回 / 分 ※120回 / 分 ※130回 / 分 ※1
POST/v2beta/rightsupport/contactData/upsert20回 / 分25回 / 分50回 / 分
POST/v2beta/rightsupport/contactData/deleteById10回 / 分15回 / 分30回 / 分
POST/v2beta/operation/status/get6000回 / 分6000回 / 分6000回 / 分
POST/v2/account/list5回 / 分25回 / 分50回 / 分
POST/v2beta/account/create10回 / 分15回 / 分30回 / 分
POST/v2beta/account/delete10回 / 分15回 / 分30回 / 分
POST/v2beta/project/role/list10回 / 分25回 / 分50回 / 分
POST/v2beta/project/role/create10回 / 分15回 / 分30回 / 分
POST/v2beta/project/role/delete10回 / 分15回 / 分30回 / 分

※1 /v2/talk/message/sendFromOperator /v2/talk/message/sendFromUser /v2beta/talk/note/send へのリクエストは合算してカウントします。合算したリクエスト数に対して分間制限が適用されます。

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

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

429 Too Many Request 

よくある質問

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

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