レート制限

Manako の各エンドポイントに適用されるレート制限の仕様です。

Public API（/api/v1/*）

2 段階の制限があり、どちらかを超えると HTTP 429 が返ります。

制限の単位	上限
送信元 IP アドレス	300 リクエスト / 分
API キー（プラン別）	Free: 60 / Pro: 180 / Business: 300 リクエスト / 分

上限を超えた場合

• ステータスコード 429 とエラーコード RATE_LIMITED が返ります
• レスポンスの Retry-After ヘッダーに、再試行までの待機秒数が入ります

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "status": 429
  }
}

ノート

制限は近似的なカウント方式のため、ごく短時間のバーストでは設定値をわずかに超えて受理されることがあります。上限値ちょうどに依存した設計は避けてください。

クライアント実装のガイドライン

• 429 を受け取ったら Retry-After 秒待ってから再試行してください
• ポーリングの代わりに Webhook サブスクリプションの利用を検討してください（イベント駆動なら API 呼び出し回数を大幅に減らせます）

ハートビート受信エンドポイント

Heartbeat モニターの ping 受信 URL には、Public API とは別の制限が適用されます。

• 送信元 IP アドレスごとに 60 リクエスト / 分
• 超過時は 429 が返ります（ping は記録されません）

ヒント

Heartbeat の ping はジョブ 1 実行につき 1 回で十分です。リトライループの中から ping を送らないようにしてください。