服务端 API 错误码
本文档汇总 APP 服务端调用 OpenPaaS 服务端 API 时可能返回的错误码。接口返回失败时,可根据响应体中的错误码和错误信息定位问题,再结合当前接口入参、鉴权凭证、签名加密配置进行排查。
一、错误码说明
0表示成功。- 非
0表示失败,需结合接口返回的错误信息与当前调用场景处理。 - 「错误信息」为服务端返回的英文错误描述,「说明」为对应的中文含义。
二、错误码表
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| -1 | system error | 系统错误 |
| 0 | ok | 成功 |
| 54101 | API_Missing_Sud_Timestamp | 缺少Sud时间戳 |
| 54102 | API_Missing_Sud_Signature | 缺少Sud签名 |
| 54103 | API_Missing_Sud_AppId | 缺少Sud应用ID |
| 54104 | API_Invalid_Signature | 无效的签名 |
| 54105 | API_Invalid_Encrypt | 无效的加密 |
| 54106 | API_Invalid_Sud_AppId | 无效的Sud应用ID |
| 54107 | API_Invalid_Sud_AppIdMatch | Sud应用ID不匹配 |
| 54108 | API_NoExist_DevSecretSym | 对称密钥不存在 |
| 54109 | API_NoExist_DevSecretAsym | 非对称密钥不存在 |
| 54201 | invalid grant_type | 无效的授权类型 |
| 54202 | invalid app_id | 无效的app_id |
| 54203 | invalid secret | 无效的密钥 |
| 54210 | invalid gameid | 无效的游戏ID |
| 54211 | no linked game | 未关联游戏 |
| 54212 | no available game package | 未找到可用游戏包 |
| 54213 | missing data asymmetric key | 缺少数据非对称密钥 |
| 54221 | invalid sud trade no | 无效的Sud交易号 |
| 54222 | invalid app reward query url | 无效的奖励查询URL |
| 55001 | server busy, please retry | 服务繁忙,请重试 |
三、排查建议
- 签名与加密类错误(如
54101、54102、54104、54105)优先检查请求头、时间戳、签名算法、加密参数和密钥配置是否一致。 - 应用凭证类错误(如
54103、54106、54107、54202、54203)优先核对应用 ID、密钥、后台配置和当前调用环境。 - 业务参数或配置类错误(如
54201、54210、54211、54212、54213、54221、54222)需结合具体 API 文档检查请求参数、游戏关联、游戏包和数据密钥配置是否合法。 - 服务繁忙(
55001)可稍后重试;如果持续出现,建议记录请求 ID、接口路径和时间点后排查服务状态。
