跳到主要内容

速率限制

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 代表申请提升。

下一步

  • 错误处理:错误响应格式和状态代码。
  • 身份验证:保持测试和实时 API 密钥正确地范围限定到各自的环境。