| 错误码 | 含义 | 建议处理 |
|---|---|---|
INVALID_REQUEST | 请求体或查询参数不合法。 | 修正连接器请求。 |
INVALID_TOKEN | token 缺失、过期、吊销或格式错误。 | 重置或重新配置 site token。 |
INSUFFICIENT_SCOPE | token 没有当前能力权限。 | 签发包含对应 scope 的 token。 |
INSUFFICIENT_QUOTA | SaaS 额度不足。 | 充值或降低任务量。 |
RATE_LIMITED | 请求过于频繁。 | 遵循 Retry-After 并降低重试压力。 |
CONNECTOR_DISABLED | 连接器已禁用。 | 在 GrowthOS 后台重新启用。 |
RESOURCE_CONFLICT | 另一个并发操作仍在执行。 | 按 Retry-After 延迟重试。 |
JOB_EXPIRED | 任务租约或 claim token 已失效。 | 重新领取任务或检查 worker 日志。 |
IDEMPOTENCY_CONFLICT | 同一个幂等键用于不同请求体。 | 同一 key 只用于完全相同的重试。 |
NOT_FOUND | 目标资源不存在。 | 刷新本地状态后再判断是否重试。 |
UPSTREAM_ERROR | 下游服务失败。 | 退避重试或展示安全兜底。 |
NETWORK_ERROR | 网络或超时失败。 | 保持幂等并退避重试。 |
基础
错误码
Connector API 常见错误和处理建议。
错误响应结构: