错误处理

错误使用标准的 HTTP 状态码。失败的请求不会被计费 — 您只需为成功的 200 响应付费。

状态码

状态码	含义
`400`	错误的请求 — 未知的提供商 ID，或者本应已认证的会话缺少密钥。
`401`	缺少或无效的 API 密钥。
`402`	余额不足 — 请为您的账户充值。请参阅计费。
`404`	未找到结果（所有提供商都未命中，或 `/random` 的索引为空）。
`429`	超出速率限制或每日配额。请根据 `Retry-After` 响应头等待后重试。
`499`	客户端在提供商响应之前关闭了请求。

错误返回一个 JSON 响应体，包含机器可读的 code 和人类可读的 message：

{
  "code": "NOT_FOUND",
  "message": "No result found for \"SSIS-999\"."
}

当达到速率限制时，请使用 Retry-After 响应头中的值（秒）进行退避：

if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 1);
  await new Promise((r) => setTimeout(r, wait * 1000));
}