# 祈盟SDK 接口清单

> 来源: Apipost OpenAPI 文档 (v1.0.0)
> 接口总数: 87 个路径

---

## 一、接口总览（按业务模块分类）

### 1. 公共模块
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| GET | `/v2.Captcha/getCaptcha` | 图形验证码 | 多处复用（注册、绑定、忘记密码、新设备判断） |
| POST | `/v2.CheckUpdate/version.html` | 安卓热更新（进入游戏时） | 客户端小文件更新 |
| POST | `/v2.game_notify/index_v2` | 游戏公告&强更&分包更新-v2 | 准备弃用 |
| POST | `/v2.game_notify/index_v3` | 游戏公告&强更&分包更新-v3 | 替代v2 |
| POST | `/v2.privacy/privacy` | 协议内容获取 | |
| GET | `http://qm_url.7dgame.cn/` | 获取请求域名地址（正式） | |
| GET | `http://qm_url.7dgame.cn/dev` | 获取请求域名地址（测试） | |
| POST | `/game/getChannelOrGame` | 获取渠道和游戏数据（H5） | |

### 2. 注册&登录模块
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v1.login/index.html` | 账户登录 | |
| POST | `v1.login/checkToken.html` | 自动登录（Token校验） | |
| POST | `/v1.login/logout.html` | 退出登录 | |
| POST | `/v1.login/third` | 第三方用户登录 | |
| POST | `/v1.register/index.html` | 手机号注册 | |
| POST | `/v1.register/createUsername.html` | 注册生成用户名 | |
| POST | `/v1.send_sms/index.html` | 发送短信验证码 | 手机注册/忘记密码/绑定手机号共用 |
| POST | `/v1.is_identity/isVerified.html` | 是否已实名认证 | 登录+充值前调用 |
| POST | `/v1.Is_Identity/isLoginPopup.html` | 是否实名认证弹窗 | 登录后调用 |
| POST | `/v2.user/personalIdentity` | 实名认证 | |
| POST | `/v2.user/userinfo` | 用户详情 | |
| POST | `/v2.config/getconfig` | 第三方登录参数配置 | |

### 3. 绑定手机号
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.user/getBindPhoneCode` | 获取验证码（绑定/换绑） | |
| POST | `/v2.user/bindPhone` | 手机号绑定 | |

### 4. 忘记密码
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.forget/resetPwdSendCode` | 发送验证码 | 流程1 |
| POST | `/v2.forget/resetPwdCheckCode` | 效验验证码 | 流程2 |
| POST | `/v2.forget/forgetPwdToReset` | 重置密码 | 流程3 |

### 5. 新设备判断
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.user/newImeilValid` | 验证验证码 | |
| POST | `/v2.user/getNewImeiCode` | 验证码获取 | |

### 6. 我的（用户中心）
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.user/updatePwd` | 密码修改 | |
| POST | `/v2.user/problem` | 常见问题 | |
| POST | `/v2.user/getChannelCall` | 专属客服 | |
| POST | `/v2.AiAssistant/getConfig` | AI助手配置 | |

### 7. 换绑手机号
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.user/unbindingPhoneCode` | 旧手机号-获取验证码 | |
| POST | `/v2.user/checkUnbindingPhoneCode` | 旧手机号-效验验证码 | |
| POST | `/v2.user/unbindingPhone` | 换绑-绑定新手机号 | |

### 8. 订单模块
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.order/orderList` | 订单列表 | |
| POST | `/v2.order/orderInfo` | 订单详情 | |
| POST | `/v2.order/cancelOrder` | 取消订单 | 充值/支付共用 |

### 9. 充值（平台币）
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.coin/payType` | 支付方式列表 | |
| POST | `/v2.coin/pay` | 发起充值 | |
| POST | `/v2.order/getMemberCoinList` | 交易明细列表 | |

### 10. 代金券
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.coupon/getcoupon` | 可领取代金券列表 | |
| POST | `/v2.coupon/getMyCoupon` | 我的代金券列表 | |
| POST | `/v2.coupon/exchangeCoupon` | 兑换代金券码 | |
| POST | `/v2.coupon/receiveCoupon` | 领取代金券 | |

### 11. 礼包
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.Gift/giftList` | 礼包列表 | |
| POST | `/v2.Gift/getMyGiftList` | 我的礼包列表 | |
| POST | `/v2.Gift/giftPack` | 领取礼包 | |

### 12. SDK 支付（游戏内购买道具）
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.order/getPayInfo` | 获取支付信息 | |
| POST | `/v1.pay/index.html` | 发起支付 | |
| POST | `/v1.pay/querypay.html` | 订单信息查询 | |

### 13. 支付回调（SDK）
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| GET | `/v1.pay_notify/xty_pay.html` | 喜钛游-支付回调 | |
| POST | `/v1.pay_notify/qzl_pay.html` | 趣智连-支付回调 | |
| GET | `/index/notidy` | 支付回调示例 | |
| GET | `/v1.pay_notify/dianhun` | 电魂订单通知 | |

### 14. 角色管理
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v1.role/index.html` | 角色数据上传 | |

### 15. 聚合渠道
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v1.complex_login/getSpecialParam` | 1. 渠道效验(获取用户ID) | |
| POST | `/v1.complex_login/index.html` | 2. 登录效验 | |
| POST | `/v1.complex_pay/index.html` | 3. 发起下单 | |
| POST | `/v2.complex_authentication/check` | 4. 渠道实名认证 | 非必请求，客户端+对接方使用 |
| POST | `/v2.complex/handle.html` | 5. 角色上传接口 | |
| POST | `/v2.complex_authentication/query` | (弃用)实名认证结果查询 | |

### 16. 聚合游戏回调-服务端（渠道支付回调）
| 方法 | 路径 | 渠道 |
|------|------|------|
| POST | `/v1.complex_pay_notify/notify/channelqf/congyu/gameidqf/10` | 从语 |
| POST | `/v1.complex_pay_notify/notify/channelqf/test/gameidqf/10` | 测试渠道 |
| POST | `/v1.complex_pay_notify/notify/shenqi/gameidqf/10` | 神起 |
| POST | `/v1.complex_pay_notify/notify/yueyou/gameidqf/10` | 悦游 |
| POST | `/v1.complex_pay_notify/notify/sanjiu/gameidqf/10` | 三九互娱 |
| POST | `/v1.complex_pay_notify/notify/youxiyou/gameidqf/10` | 游戏友 |
| POST | `/v1.complex_pay_notify/notify/channelqf/weilian/gameidqf/20` | 唯恋 |
| POST | `/v1.complex_pay_notify/notify/channelqf/jlyx/gameidqf/10` | 神龙游戏 |
| GET | `http://sdkapi.newsdk.com/v1.complex_pay_notify/notify/channelqf/tlyx/gameidqf/10` | 贪乐 |

### 17. 第三方平台
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v2.Third/getDyCode` | 抖音游戏-获取access_token | |
| POST | `/v2.Third/getDyAuthInfoOpen` | 抖音游戏-查询绑定意愿 | |
| POST | `/v2.Third/getJumpAuthCallback` | 抖音-游戏内授权后回调 | |

### 18. 抖音游戏平台
| 方法 | 路径 | 功能 |
|------|------|------|
| POST | `/v2.DyGameOpen/getAuthLogin` | 抖音-授权登录 |
| POST | `/v2.DyGameOpen/getMobileCode` | 抖音-手机号发送验证码 |
| POST | `/v2.DyGameOpen/getMobileCheck` | 抖音-手机号验证码校验 |
| POST | `/v2.DyGameOpen/getRoleList` | 抖音-获取角色列表 |
| POST | `/v2.DyGameOpen/HandleEventNotice` | 抖音-绑定事件通知 |

### 19. 直播平台（数据查询）
| 方法 | 路径 | 功能 |
|------|------|------|
| POST | `/gh/get_role` | 获取角色数据 |
| POST | `/gh/get_pay_list` | 获取订单列表数据 |
| POST | `/gh/get_sub_user_list` | 获取注册归属列表数据 |
| POST | `/gh/get_player_active` | 获取玩家活跃数据列表 |
| POST | `/gh/channel_data_summary` | 获取渠道数据汇总（弃用） |
| POST | `/gh/channel_data_summary_v2` | 获取渠道数据汇总V2 |
| POST | `/gh/get_sub` | 获取游戏账户列表 |

### 20. 服务端效验
| 方法 | 路径 | 功能 | 备注 |
|------|------|------|------|
| POST | `/v1.helper/checkToken.html` | CP登录二次效验 | 服务端+聚合渠道 |

### 21. AI助手
| 方法 | 路径 | 功能 |
|------|------|------|
| POST | `/v2.AiAssistant/getConfig` | AI助手配置 |

### 22. 其他
| 方法 | 路径 | 功能 |
|------|------|------|
| POST | `/v2.user/getYqlChannel` | 获取176的渠道推广信息 |

---

## 二、接口流程说明

### 登录流程
```
1. 图形验证码 → /v2.Captcha/getCaptcha
2. 登录 → /v1.login/index.html
3. 实名认证检查 → /v1.is_identity/isVerified.html
4. 实名认证弹窗 → /v1.Is_Identity/isLoginPopup.html
5. 自动登录(Token刷新) → v1.login/checkToken.html
```

### 注册流程
```
1. 图形验证码 → /v2.Captcha/getCaptcha
2. 发送短信验证码 → /v1.send_sms/index.html
3. 手机号注册 → /v1.register/index.html
4. 生成用户名 → /v1.register/createUsername.html
```

### 忘记密码流程
```
1. 图形验证码 → /v2.Captcha/getCaptcha
2. 发送验证码 → /v2.forget/resetPwdSendCode
3. 效验验证码 → /v2.forget/resetPwdCheckCode
4. 重置密码 → /v2.forget/forgetPwdToReset
```

### 游戏支付流程
```
1. 实名认证检查 → /v1.is_identity/isVerified.html
2. 获取支付信息 → /v2.order/getPayInfo
3. 发起支付 → /v1.pay/index.html
4. 查询订单 → /v1.pay/querypay.html
5. 支付回调（渠道推送）
```

### 聚合渠道对接流程
```
1. 渠道效验 → /v1.complex_login/getSpecialParam
2. 登录效验 → /v1.complex_login/index.html
3. 发起下单 → /v1.complex_pay/index.html
4. 渠道实名认证（可选）→ /v2.complex_authentication/check
5. 角色上传 → /v2.complex/handle.html
6. 支付回调（渠道推送）
```

### 绑定手机号流程
```
1. 图形验证码 → /v2.Captcha/getCaptcha
2. 获取验证码 → /v2.user/getBindPhoneCode
3. 绑定手机号 → /v2.user/bindPhone
```

### 换绑手机号流程
```
1. 旧手机号获取验证码 → /v2.user/unbindingPhoneCode
2. 旧手机号效验验证码 → /v2.user/checkUnbindingPhoneCode
3. 绑定新手机号 → /v2.user/unbindingPhone
```

---

## 三、签名规则

```
1. 去掉 sign 参数
2. 按 key 升序排列
3. 拼接 key=value 并追加 appkey
4. 转换为小写（含罗马数字特殊转换）
```

---

## 四、公共参数

| 参数 | 说明 | 必填 |
|------|------|------|
| device | 设备来源(1=PC, 2=安卓, 3=苹果, 4=H5) | 是 |
| channel_id | 渠道ID | 是 |
| appid | 应用ID | 是 |
| gameid | 游戏ID | 是 |
| imeil | 设备号 | 是 |
| version | 版本号 | 是 |
| token | 登录Token | 否 |

---

## 五、响应码约定

| 响应码 | 含义 |
|--------|------|
| 100 | 登录失效 |
| 110 | 参数有误 |
| 120 | 处理提示 |
| 130 | 执行异常 |
| 200 | 正常 |

---

## 六、外部渠道回调汇总

| 渠道 | 回调路径 |
|------|---------|
| 喜钛游 | `/v1.pay_notify/xty_pay.html` |
| 趣智连 | `/v1.pay_notify/qzl_pay.html` |
| 电魂 | `/v1.pay_notify/dianhun` |
| 从语 | `/v1.complex_pay_notify/notify/channelqf/congyu/gameidqf/10` |
| 神起 | `/v1.complex_pay_notify/notify/shenqi/gameidqf/10` |
| 悦游 | `/v1.complex_pay_notify/notify/yueyou/gameidqf/10` |
| 三九互娱 | `/v1.complex_pay_notify/notify/sanjiu/gameidqf/10` |
| 游戏友 | `/v1.complex_pay_notify/notify/youxiyou/gameidqf/10` |
| 唯恋 | `/v1.complex_pay_notify/notify/channelqf/weilian/gameidqf/20` |
| 神龙游戏 | `/v1.complex_pay_notify/notify/channelqf/jlyx/gameidqf/10` |
| 贪乐 | `/v1.complex_pay_notify/notify/channelqf/tlyx/gameidqf/10` |