错误处理

所有错误返回包含 error 字段的 JSON 对象：

{
  "error": "not enough storage, please upgrade your plan"
}

如需设置 API 密钥，请参阅身份验证；如需一次性批量上传多个文件，请参阅 CAR 导入。

状态码

代码	含义	常见原因
400	错误请求	缺少或无效的参数，不支持的内容类型，无效的 JSON 正文。
401	未授权	缺少或无效的 API 密钥。
402	需要付款	存储空间超出限制 — 升级您的计划或等待每月重置。
404	未找到	文件 CID 或用户未找到。
429	请求过多	网关带宽限制已超出 — 等待每月重置。
500	内部错误	意外的服务器错误 — 重试或联系支持。

4xx 客户端错误

4xx 状态码表示请求本身存在问题。请检查您的 API 密钥是否有效（401）、请求正文是否为格式正确的 JSON（400），以及存储配额是否已超出（402）。在重试之前请先修正问题所在 — 重复发送同样有误的请求只会得到相同的错误。

5xx 服务器错误

500 响应表示服务器端出现了意外问题。请稍等片刻后重试；如果问题仍然存在，请联系支持团队并附上响应头中的请求 ID。5xx 错误通常与请求正文无关，因此无需修改负载内容。