速率限制
k-ID 平台强制执行两种独立的速率限制:
- API 速率限制适用于从您的服务器对 k-ID API 的直接调用。超出限制时,请求将返回 HTTP
429 Too Many Requests。 - 年龄验证和家长同意流程速率限制适用于面向用户的流程(年龄验证小部件和 VPC 挑战)。超出限制时,用户将看到流程内错误,提示其稍后再试。
两种限制在实时模式和测试模式之间有所不同,且都按产品强制执行。
API 速率限制
对 k-ID API 的调用按产品进行速率限制。超出限制的请求将收到无响应正文的 HTTP 429 响应。
| 模式 | 默认限制 |
|---|---|
| 实时模式 | 500 RPS |
| 测试模式 | 10 RPS |
处理 429 响应
收到 429 时,您的集成应当:
- 在短暂的冷却期内停止发送新请求。
- 使用带抖动的指数退避进行重试,而不是紧密的重试循环。
- 在可能的情况下缓存响应(例如,会话和年龄门控要求)。
- 合并对同一资源的重复并发请求。
有关 HTTP 状态代码和错误格式的完整列表,请参阅错误处理。
年龄验证和家长同意流程速率限制
面向用户的年龄验证和家长同意流程(包括托管的小部件 URL 和挑战流程)与直接 API 调用分开进行速率限制。这些限制也按产品强制执行。
| 模式 | 默认限制 |
|---|---|
| 实时模式 | 100 RPS |
| 测试模式 | 20 RPS |
超出此限制时,用户将看到流程内错误,提示其稍后再试。429 不会传递到您的服务器。此限制独立于上一节描述的 API 速率限制,并在其之上叠加:单次用户旅程可以同时消耗两个桶的容量。
默认限制和申请提升
需要更高的限制?
本页中的数字是分配给每个产品的默认速率限制。如果您的产品需要更高的容量(例如,用于发布、营销活动或持续的更高流量),请联系您的 k-ID 代表申请提升。