基础调用频率限制
广州智能双录系统对API接口的调用频率设有严格限制,旨在保障服务稳定性及防止恶意刷量，不同业务场景下的接口拥有独立的限流阈值，开发者需根据实际业务需求合理规划调用节奏。
| 接口类型 | 限流策略 | 说明 |
|---|---|---|
| 通用查询接口 | 每秒50次 (QPS) | 适用于状态查询、基础信息获取等非高频操作。 |
| 视频上传接口 | 每秒10次 (QPS) | 鉴于视频文件体积较大，上传接口限制较严，建议采用分片上传或异步处理。 |
| 结果回调通知 | 无硬性QPS限制 | 系统主动推送结果，但需确保接收端具备高并发处理能力，避免超时导致重试堆积。 |
| 批量处理接口 | 每分钟100次 | 适用于批量任务提交，超出限制将返回429 Too Many Requests错误。 |
并发连接与资源配额
除了频率限制外,系统还对并发连接数和单次请求的数据大小进行了约束，并发连接数指同一时间处于活跃状态的HTTP连接数量，若超过阈值，新连接将被拒绝或排队等待。
- 最大并发连接数：单个API Key默认支持的最大并发连接数为20，如需更高并发，需提前向平台申请扩容。
- 单次请求大小限制：
- 文本类参数：最大支持10KB。
- 文件类参数（如视频片段）：单次上传最大支持50MB，若视频超过此限制，必须使用分片上传接口。
- 会话保持时间：双录会话建立后，若超过30分钟无交互或心跳包发送，会话将自动失效，需重新发起请求。
错误处理与重试机制
当触发限流或遇到网络波动时,API会返回特定的错误码，开发者应实现指数退避（Exponential Backoff）重试策略，避免瞬间重试加剧服务器压力。
- 429 Too Many Requests：表示触发频率限制，建议等待至少1-2秒后重试，并根据错误头中的
Retry-After字段调整等待时间。 - 503 Service Unavailable：表示服务暂时不可用，建议等待5秒后重试，若连续失败超过3次，应暂停该API Key的调用并联系技术支持。
- 重试上限：单个请求最多重试3次，超过后应视为失败并记录日志，避免无限重试导致资源耗尽。
安全与鉴权限制
为确保数据安全,API调用需携带有效的鉴权令牌（Token），令牌有效期为2小时，过期后需重新获取。
- Token刷新频率：建议每1.5小时刷新一次Token，避免在业务高峰期因Token过期导致调用失败。
- IP白名单限制：若配置了IP白名单，仅允许白名单内的IP地址发起请求，若服务器IP变更，需及时在控制台更新白名单，否则请求将被拒绝。
- 签名验证：所有请求需包含签名参数，签名算法错误或缺失将直接导致请求被拒，且不计入限流统计。
相关问题与解答
如果我的业务高峰期并发量超过20个连接，应该如何处理？
解答：
您可以登录广州智能双录API控制台，提交“并发配额扩容申请”，申请时需说明业务场景、预估峰值QPS及并发连接数，审核通过后，您的API Key将支持更高的并发连接数，建议在应用层实现连接池管理，合理复用HTTP连接，避免频繁创建和销毁连接带来的开销。
视频上传失败返回429错误，但我的调用频率并未达到限制，可能是什么原因？
解答：
429错误不仅由QPS触发，还可能由以下原因引起：
- 分片上传限制：如果您使用分片上传，每个分片的上传频率也受限于每秒10次，若同时上传多个大视频的分片，可能触发局部限流。
- Token过期或无效：虽然通常返回401错误，但在某些网关配置下，鉴权失败也可能被统一拦截为429。
- IP白名单变更：若服务器IP不在白名单内，请求可能被网关直接丢弃并返回限流类错误。
建议检查日志中的具体错误信息，确认是否涉及鉴权或IP问题，并优化分片上传策略，错开不同视频的上传时间。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/484436.html
