限制与大小

为保持平台稳定，API 对请求频率和传输数据大小有所限制。

请求频率

超过允许的请求频率时，服务器返回 429 Too Many Requests。正确的处理方式是使用指数退避重试：逐步增加重试间隔，不要密集发送请求。将批量操作分散到时间轴上，并顺序复用同一令牌，而非并发突发请求。

请求体大小

普通 REST 请求的 JSON 请求体限制为 2 MiB。这对于任何反应配置、集合和设置都已足够。如果请求体更大，请分批操作（例如分批导入反应）。

导入请求体大小

导入端点为大型包设计，有单独的更高限制：数据导入最大 64 MiB，带内嵌媒体的导入最大 256 MiB。如果包更大，请拆分为多次导入。

超出限制

  • 超过频率限制 — 429，使用退避重试。
  • 请求体超出限制 — 请求被拒绝（413 或 400，取决于端点）；请减小或拆分数据负载。

下一步