速率限制与配额策略

为了保证服务稳定性和公平使用，龙虾出行对每个开放平台应用（App）按 Bearer Token 维度设置以下速率限制与配额策略。

默认限制：每个应用每秒最多 20 次请求（QPS）。

不同业务模块的默认上限：

实际限制以应用注册时签约的 qps_limit 为准。

超限处理：

触发 QPS 上限时返回 HTTP 429，业务码 42901

触发日调用上限时返回 HTTP 429，业务码 42902

响应示例：

{
  "code": 42901,
  "message": "触发 QPS 上限",
  "data": null,
  "request_id": "f3c2a1b4d5e6f7890123456789abcdef"
}

2. 每日 / 每月配额

默认配额：

企业开发者 / 付费应用：可按需求申请更高配额

实际配额以应用注册时签约的 daily_limit 为准；触达上限会立即返回 42902，次日 0 点（北京时间）自动重置。

临时提速：高峰活动或批量灌数据场景，可联系开放平台运营临时提升 qps_limit / daily_limit。

长期升级：企业开发者可通过协议方式升级配额及调用速率，并申请独立的 IP 白名单与多 Token 隔离。

在客户端实现指数退避（建议初始 1s，最多 5 次重试）以应对偶发限流。

命中 429 时优先依据 request_id 排查是否存在重复请求，再决定是否重试。

大批量灌数据场景请优先使用「数据查询」类接口，避免无意义地反复触发「下单」类接口的低 QPS。