常见错误码 - 出海兽Agent · 开放平台

大多数可预期错误仍会返回 HTTP 200。客户端必须同时判断 HTTP 状态、JSON success 和 code，不能把 HTTP 200 直接视为业务成功。

鉴权与接口错误

code	含义	处理建议	可原样重试
`10101`	获取 Token 时缺少 `app_id`	补齐 APP_ID 后重新请求	否
`10105`	获取 Token 时缺少 `signature`	重新计算并提交签名	否
`10000`	APP_ID 不存在或应用已停用	检查应用 ID 与控制台状态	否
`10108`	Token 签名不匹配	检查 APP_SECRET、排序、RFC1738 编码、毫秒时间戳和小写 MD5	否
`10103`	业务请求缺少 `X-Legacy-Token`	先获取 Token，再放入请求头	否
`10104`	Token 无效、损坏、过期或无法解析	获取新 Token 后再调用	获取新 Token 后
`10020`	Token 所属应用与接口授权不匹配	使用正确应用的 Token，或确认应用权限	否
`10001`	请求频率过高	指数退避并增加随机抖动	是，退避后
`2100`	接口路径不存在	检查 API 参考中的完整路径	否
`2200`	接口已停用	停止调用并等待恢复	否
`2000`	HTTP 方法不正确	使用接口页指定的 GET 或 POST	否
`2150`	请求参数不符合规则，或业务方法异常	根据 `message` 修正参数；不确定时提供 `requestId`	通常否
`1003`	无权访问目标资源	检查资源归属和应用权限	否
`1001`	业务处理过程中 Token 过期	获取新 Token 后再调用	获取新 Token 后

业务与社媒错误

code	含义	处理建议
`500`	智能任务或海外社媒业务处理失败	保存 `requestId` 和 `message`；创建结果不确定时先查状态，避免重复创建
`404`	社媒账号、帖子或其他本地资源不存在，或不属于当前应用	检查 `social_account_id`、`post_id` 等资源 ID 和归属
`90001`	海外社媒服务暂未配置完成	调用方无法修复，携带 `requestId` 联系平台支持

说明任务 status 不是错误码。-1/0/1/2 分别表示失败、等待、成功和执行中，详见异步任务生命周期。社媒帖子和评论还会返回字符串状态。

HTTP 状态仍然有意义

HTTP 200：请求已被平台接收并形成结构化响应，业务是否成功仍看 success 与 code。
HTTP 401：未被业务层转换的 Token 异常。
HTTP 403：未被业务层转换的权限异常。
HTTP 4xx：请求未到达正常业务处理，按响应中的 message 修正请求。
HTTP 500：服务器未预期异常。不要高频重试，保存 requestId 后联系支持。

推荐判断顺序

JavaScript

const response = await fetch(url, options)
const payload = await response.json().catch(() => null)

if (!response.ok) {
  throw new Error(payload?.message || `HTTP ${response.status}`)
}
if (!payload?.success) {
  const error = new Error(payload?.message || '业务请求失败')
  error.code = payload?.code
  error.requestId = payload?.requestId
  throw error
}

return payload.data

不要把 APP_SECRET、Token、完整签名原文或个人数据放进日志和工单。