请求限流

限流维度

请求频率按 应用（appId）+ 接口计算。同一应用下，不同机构、AccessToken、服务器和并发任务访问同一接口时，共享调用额度。

查询参数不同，仍共享额度

同一应用查询同一接口的不同日期、页码或筛选条件，共享该接口的额度。例如，以下两次收费明细查询只是分页位置不同，合计使用同一份 10 次/秒的额度。

GET /api/v2/open-agency/stat/revenue/detail/items?date=2026-11-01&offset=0&limit=20
GET /api/v2/open-agency/stat/revenue/detail/items?date=2026-11-01&offset=20&limit=20

路径中的 ID 不同，仍属于同一接口

以下两个请求的患者 ID 不同，但都属于 /api/v2/open-agency/patient/{patientId} 接口。同一应用的这些请求共享 150 次/秒的额度，不按患者 ID 分别计算。

GET /api/v2/open-agency/patient/11111111111111111111111111111111
GET /api/v2/open-agency/patient/22222222222222222222222222222222

请求方法不同，仍共享额度

同一应用对相同路径发起 GET、PUT 等不同方法的请求，共享额度。例如，以下获取患者详情（GET）和修改患者（PUT）的请求，合计使用同一份 150 次/秒的额度。

GET /api/v2/open-agency/patient/11111111111111111111111111111111
PUT /api/v2/open-agency/patient/11111111111111111111111111111111

调用频率

默认每个应用对每个接口的请求频率上限为 150 次/秒。获取 AccessToken 和“收费明细-明细”（/api/v2/open-agency/stat/revenue/detail/items）的上限单独规定如下；“收费明细-分类”和“收费明细-单据”使用默认上限。

慢请求保护

慢请求保护按整个 appId累计。从首次慢请求开始的 5 分钟内，累计出现 3 次耗时达到下表阈值的请求后，网关会暂停该应用的后续请求 60 秒。

慢请求保护与接口频率限制分别计算，限制范围包括同一应用的其他接口。

限流响应

{
  "data": null,
  "error": {
    "code": 429,
    "message": "访问频率过快"
  }
}

限流响应不返回 Retry-After，默认不提供剩余额度响应头。

其他错误的排查方式见 常见错误与排查。