错误响应结构:
{
  "ok": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Missing or invalid API token."
  },
  "requestId": "req_123"
}
错误码含义建议处理
INVALID_REQUEST请求体或查询参数不合法。修正连接器请求。
INVALID_TOKENtoken 缺失、过期、吊销或格式错误。重置或重新配置 site token。
INSUFFICIENT_SCOPEtoken 没有当前能力权限。签发包含对应 scope 的 token。
INSUFFICIENT_QUOTASaaS 额度不足。充值或降低任务量。
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网络或超时失败。保持幂等并退避重试。