错误码

Agent Token 认证错误

错误信息	原因	解决方案
Authorization header is required	缺少 Authorization Header	添加 Authorization: Bearer {token}
Authorization header format must be Bearer {token}	Header 格式不正确	确认格式为 Bearer<空格>{token}
Invalid token format	Token 不是三段式	确认 Token 格式为 key.timestamp.signature
Invalid token: missing required parts	Token 某部分为空	检查各部分是否都有值
Invalid token: invalid timestamp	时间戳不是合法数字	确认 timestamp 为 Unix 秒级时间戳
Token expired	时间戳超出 ±2 分钟窗口	检查服务器时间，使用当前时间戳重新生成
Invalid agent credentials	API Key 无效或未找到	确认 agent_api_key 正确
Invalid token signature	签名不匹配	确认 agent_api_secret 正确，检查签名算法

通用错误码

错误码	Message	说明
0	success	成功
1001	err.param.invalid	参数缺失或格式错误
1002	err.signature.invalid	签名验证失败
1003	err.request.timeout	请求超时
1004	err.request.duplicate	重复请求（幂等性拦截）

玩家相关

错误码	Message	说明
2001	err.player.not_found	玩家不存在
2002	err.player.duplicate	玩家已存在（注册重复）
2003	err.player.disabled	玩家已被禁用
2004	err.player.password_invalid	密码错误
2005	err.player.register_failed	玩家注册失败
2006	err.player.member_id_invalid	member_id 格式错误

资金相关

错误码	Message	说明
3001	err.fund.insufficient_balance	余额不足
3002	err.fund.invalid_amount	转账金额无效（为 0 或超出限制）
3003	err.fund.duplicate_transfer	转账流水号重复
3004	err.fund.transfer_pending	转账处理中，请稍后查询
3005	err.fund.currency_not_supported	不支持的货币代码

游戏相关

错误码	Message	说明
4001	err.game.not_found	游戏不存在或已下线
4002	err.game.maintenance	游戏维护中
4003	err.game.type_unsupported	不支持的游戏类型
4004	err.game.platform_unsupported	不支持的平台类型
4005	err.game.launch_failed	游戏启动失败
4006	err.game.access_denied	游戏访问权限不足（代理未开通该游戏）

游戏商相关

错误码	Message	说明
5001	err.provider.unavailable	游戏商不可用
5002	err.provider.call_failed	游戏商接口调用失败
5003	err.provider.abnormal_response	游戏商返回异常
5004	err.provider.unsupported	不支持的游戏商
5005	err.provider.feature_unsupported	该游戏商不支持此功能