Errors

错误码

OpenAPI 使用 HTTP 状态码与统一响应体。客户端可以优先依据 HTTP status 分流，也可以读取 body 中的 code 与 message。

HTTP 错误码

状态码	含义	常见原因
`400`	参数错误	cursor 解析失败、since 缺失、limit 非法、枚举值非法。
`401`	鉴权失败	缺少 API Key、API Key 无效、API Key 已禁用、Webhook 签名失败。
`403`	无权限或模式不符	LOCAL 调用 /open-api/*，或 push-only Key 调用主动拉接口。
`404`	资源不存在	达人、采集任务、同步端点或运行记录不存在，或不属于当前企业。
`429`	限流	单 Key 请求过于频繁，参考 Retry-After 与 X-RateLimit-*。
`500`	服务异常	服务端未预期错误。客户侧应记录 request 信息并联系支持。

{
  "code": 403,
  "message": "开启云端共享数据模式后可用"
}