Skip to content

服务端 API 错误码 ​

本文档汇总 APP 服务端调用 OpenPaaS 服务端 API 时可能返回的错误码。接口返回失败时,可根据响应体中的错误码和错误信息定位问题,再结合当前接口入参、鉴权凭证、签名加密配置进行排查。

一、错误码说明 ​

  • 0 表示成功。
  • 非 0 表示失败,需结合接口返回的错误信息与当前调用场景处理。
  • 「错误信息」为服务端返回的英文错误描述,「说明」为对应的中文含义。

二、错误码表 ​

错误码错误信息说明
-1system error系统错误
0ok成功
54101API_Missing_Sud_Timestamp缺少Sud时间戳
54102API_Missing_Sud_Signature缺少Sud签名
54103API_Missing_Sud_AppId缺少Sud应用ID
54104API_Invalid_Signature无效的签名
54105API_Invalid_Encrypt无效的加密
54106API_Invalid_Sud_AppId无效的Sud应用ID
54107API_Invalid_Sud_AppIdMatchSud应用ID不匹配
54108API_NoExist_DevSecretSym对称密钥不存在
54109API_NoExist_DevSecretAsym非对称密钥不存在
54201invalid grant_type无效的授权类型
54202invalid app_id无效的app_id
54203invalid secret无效的密钥
54210invalid gameid无效的游戏ID
54211no linked game未关联游戏
54212no available game package未找到可用游戏包
54213missing data asymmetric key缺少数据非对称密钥
54221invalid sud trade no无效的Sud交易号
54222invalid app reward query url无效的奖励查询URL
55001server busy, please retry服务繁忙,请重试

三、排查建议 ​

  1. 签名与加密类错误(如 54101、54102、54104、54105)优先检查请求头、时间戳、签名算法、加密参数和密钥配置是否一致。
  2. 应用凭证类错误(如 54103、54106、54107、54202、54203)优先核对应用 ID、密钥、后台配置和当前调用环境。
  3. 业务参数或配置类错误(如 54201、54210、54211、54212、54213、54221、54222)需结合具体 API 文档检查请求参数、游戏关联、游戏包和数据密钥配置是否合法。
  4. 服务繁忙(55001)可稍后重试;如果持续出现,建议记录请求 ID、接口路径和时间点后排查服务状态。