错误码

API开放平台 接口统一返回结构，业务结果通过 code 字段标识。

响应结构

{
  "code": 200,
  "message": "success",
  "data": { }
}

• code：200 表示成功，其他值表示失败（与 HTTP 状态码可能一致）。
• message：可读的提示信息。
• data：业务数据（失败时可能为空）。

常见错误

code	含义	处理建议
200	成功	——
401	API Key 无效 / 已过期，或 token 失效	重新换取 token；检查 X-API-Key
402	积分余额不足（开发者池或终端用户）	控制台为积分池充值，或提示用户充值
403	无权限访问该资源	确认密钥对应账号的权限与额度
404	资源不存在	检查路径与参数（如 short_code、client_user_id）
429	触发限流	退避后重试
5xx	服务端错误	重试；持续失败请联系平台

失败响应示例

{
  "code": 401,
  "message": "API Key 无效或已过期"
}

TODO：依据后端实际返回，补全完整错误码与对应 HTTP 状态码对照表。