服务端 API
本模块为小游戏 Game SVR 与 SUD OP SVR 之间所有服务端接口的契约参考。开放接口由 Game SVR 调用 SUD OP SVR，回调接口由 Game SVR 实现并在 SUD OP 后台配置回调地址。
服务区域与接口地址
开放接口文档列出请求方法和接口路径。调用前，请根据游戏所属服务区域选择基础地址，详见服务区域与接口地址。
安全机制
本模块接口按安全要求分为两类：强制加密签名接口与明文调用接口。强制加密签名的接口必须完成服务通信二次加密和签名，可有效防止数据篡改与泄露；明文调用接口不加密、不签名，直接以标准 HTTPS 请求调用。完整算法规范见服务端 API 签名加密。
- 请求加密签名（开放接口 → SUD OP SVR）：Game SVR 调用 SUD OP SVR 开放接口时，必须先加密请求明文、再对密文生成签名，并携带加密参数与签名请求头；未加密、未签名或验签失败的请求会被直接拒绝。
- 回调验签解密（SUD OP SVR → Game SVR）：SUD OP SVR 调用 Game SVR 回调接口时，Game SVR 必须先验签、解密，确认请求来源合法后再处理业务；验签失败须直接拒绝，不得进入业务逻辑。
- 明文调用接口：请求与响应均为明文，无需构造加密报文、签名请求头或处理响应解密。
- 敏感凭证保护：
game_id、secret、access_token等凭证仅允许在 Game SVR 使用，严禁下发到客户端或前端页面。
开放接口
开放接口由 Game SVR 调用 SUD OP SVR，用于获取接口调用凭证、校验登录凭证、查询支付订单等服务端能力。
开放 - 接口调用凭证
| 名称 | 功能说明 |
|---|---|
| auth.getAccessToken | 获取接口调用凭证 |
开放 - 登录
| 名称 | 功能说明 |
|---|---|
| auth.code2session | 登录凭证校验，使用登录 code 换取用户会话信息 |
开放 - 支付
| 名称 | 功能说明 |
|---|---|
| pay.orderQuery | 查询支付订单 |
回调接口
回调接口由 Game SVR 实现并在 SUD OP 后台配置回调地址，SUD OP SVR 在相应业务事件触发时调用。 SUD OP 不限制回调 URL 的 domain 与 path，仅要求 Game SVR 按下方各接口文档约定的请求方法、请求体格式接收，并按响应格式返回数据。
必读：所有回调请求都会携带加密和签名信息，Game SVR 必须先完成验签和解密后才能信任回调内容。未验签直接处理回调存在被伪造请求攻击的风险。
回调 - 支付
| 名称 | 功能说明 |
|---|---|
| pay.notify | 支付回调，包含道具发货通知和退款通知 |
回调 - 广告
| 名称 | 功能说明 |
|---|---|
| ad.rewardNotify | 激励视频完播回调 |