速率限制与配额

速率限制可防止单一集成拖慢其他服务。在 Management API 中，速率限制按令牌计算；而在公开 API 中，则按网站、访客或客户计算。配额则不同：它限制网站可存储的资源数量（例如集合项目或 Webhook 端点），并取决于您的计划。

当您达到限制时

API 会返回 429 状态码，并附带 RATE_LIMITED 错误代码以及以秒为单位的 Retry-After 标头。请至少等待该时间，然后重试（建议使用退避算法）。

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests.",
    "details": { "retryAfter": 12 }
  }
}

当后端繁忙而非请求过多时，部分操作会返回更具体的 429 错误代码，例如 SEARCH_BUSY 或 ANALYTICS_BUSY。请以相同方式处理这些情况。

Management API

每个令牌都有各自的预算。大多数操作共享默认层级。由于分析查询较为耗费资源，因此每个令牌有较低的层级限制，且该网站上的所有令牌共享一个网站层级的上限。REST 与 MCP 调用均计入相同的预算中。

Management API 参考文档中的每项操作都会显示其层级，且 OpenAPI 文档会将其标记为 x-kanorio-rate-limit。

Content Delivery API

从边缘缓存（Edge Cache）提供的响应不计入限制，因此若繁忙网站的缓存已预热，则不会达到这些限制。缓存未命中（Cache Misses）、表单写入、分析信标与草稿预览会计入令牌桶（Token Buckets）中：每个桶会以固定速率重新填充，并允许短时间的突发流量。计数的响应会包含以下标头：

请尽可能在您的服务器或构建阶段建立页面，并让边缘缓存处理访客流量。

Customer API

已登录的调用受限于每个客户令牌。登录请求则受限于每个 IP 地址。

当前的限制与配额

以下数值是根据 API 强制执行的相同常量所产生。

Management API tiers

Content Delivery API buckets

Cache hits are not counted. Only requests that miss the edge cache, form writes and analytics beacons use these buckets.

Customer API buckets

Plan quotas