foxora

API 限流与版本

将 /v1 作为当前路径契约,并依据响应头而非硬编码请求额度处理限制。

本页内容2
  1. 步骤
  2. 预期结果

步骤

  1. 记录状态、错误代码和 x-request-id。
  2. 遇到 429,按 Retry-After 或 x-ratelimit-reset 等待。
  3. 使用指数退避、随机抖动、最长等待和最多尝试次数。
  4. 限制并发;没有安全重放说明时,不要重试非幂等操作。

预期结果

客户端可以从临时限制中恢复,避免重复工作,并明确报告不兼容路径。

注意: x-ratelimit-limit、x-ratelimit-remaining 和 x-ratelimit-reset 可能动态变化或显示 unlimited。当前路由不要求另加公共版本请求头。