Skip to content

服务端接口 ​

本模块为 APP 服务端与 SUD OP SVR 之间所有接口的契约参考。接入前请先阅读 服务端接入 了解整体流程。

服务区域与接口地址 ​

开放接口文档列出请求方法和接口路径。调用前,请根据应用所属服务区域选择基础地址,详见服务区域与接口地址。

安全机制 ​

本模块接口按安全要求分为两类:强制加密签名接口与明文调用接口。强制加密签名的接口必须完成请求加密签名与回调验签,请务必先配置相应密钥与公钥后再进行接口对接;明文调用接口不加密、不签名,直接以标准 HTTPS 请求调用。完整规范见 服务端 API 签名加密(请求与回调共用同一套「应用公私钥 / SUD OpenPaaS 证书」)。

  • 请求加密签名(开放接口 → SUD OP SVR):APP 服务端先用对称密钥对请求体加密、再用应用私钥对密文签名;未加密、未签名或验签失败的请求会被直接拒绝。
  • 回调验签(SUD OP SVR → APP 服务端):APP 服务端使用 SUD OpenPaaS 证书中的公钥对回调请求进行验签;验签失败须直接拒绝,不得进入业务逻辑。
  • 明文调用接口:请求与响应均为明文,无需构造加密报文、签名请求头,也无需处理响应解密与验签。
  • 密钥总览:见 密钥说明。

开放接口 ​

开放 - 接口调用凭证 ​

名称功能说明
auth.getAccessToken获取接口调用凭证

开放 - 游戏 ​

名称功能说明
game.getSignature获取指定游戏的签名数据

开放 - 支付 ​

名称功能说明
pay.notify向 SUD 同步支付结果
pay.refundNotify向 SUD 同步退款结果

开放 - 广告 ​

名称功能说明
ad.rewardNotify激励视频完播上报

回调接口 ​

回调接口由 APP 服务端实现并在 SUD OP 控制台配置回调地址,SUD 在相应业务事件触发时调用。 SUD 不限制回调 URL 的 domain 与 path,仅要求 APP 按下方各接口文档约定的请求方法、请求体格式接收,并按响应格式返回数据。

必读:所有回调请求都会携带 SUD OpenPaaS 的签名,APP 服务端必须先使用 SUD OpenPaaS 证书完成验签后才能信任回调内容(详见 服务端 API 签名加密)。未验签直接处理回调存在被伪造请求攻击的风险。

回调 - 支付 ​

名称功能说明
pay.orderQuery查询订单状态
pay.refund申请退款
pay.refundQuery查询退款状态

回调 - 广告 ​

名称功能说明
ad.rewardQuery激励视频完播查询