合并分支 'role_v1' 到 'release'

账号管理打通

查看合并请求 zwwl/zw_game_sdk!95

账号封禁接口.md

+v1.0
+v1.0
+
+## 封禁玩家模块接口
+
+打通掌游和游戏之间，账号违规管理： 封账号 封角色 禁言
+
+### 请求方式 
+
+   1. POST      数据结构  JSON  
+
+   2. Header数据需要加验证参数  Authorization  
+
+   3. Authorization 将请求数据，
+       a. 按照key  ascll 码小到大排序,   
+       b.拼接参数 string =    "key1=value1&key2=value2"
+       c. 将string 转为32 位的md5数据， stringMd5 = string.md5();  
+       d. 截取stringMd5 第二位到第17位， 一共 16位字符串, 之后转为大写， 为Authorization
+
+      #### 1. 禁言角色接口 
+
+      请求数据
+
+      | 字段             | 是否必传 | 字段类型 |                                           |      |
+      | ---------------- | -------- | -------- | ----------------------------------------- | ---- |
+      | banned_type      | 是       | int      | 封禁方式 ：     1  禁言角色    3 静默禁言 |      |
+      | banned_time_type | 是       | Int      | 封禁时间类型 ： 1 小时  2 天  3 永久封禁  |      |
+      | banned_time      | 是       | Int      | 封禁时间值： 例如 1  0                    |      |
+      | cp_role_id       | 是       | String   | 角色ID                                    |      |
+      | server_id        | 是       | String   | 角色注册区服ID                            |      |
+      | game_id          | 否       | int      | 创角游戏ID                                |      |
+      | zw_number        | 是       | int      | 1 2 3 4  例如掌玩1                        |      |
+      | player_id        | 是       | string   | 登录账号返回信息  唯一信息  确定账号      |      |
+
+      
+
+      返回数据
+
+      |      | 是否必要 | 字段类型 |                       |
+      | ---- | -------- | -------- | --------------------- |
+      | code | 是       | int      | 1 成功  2 失败        |
+      | msg  | 是       | string   | 返回信息  ： 封禁成功 |
+
+      #### 2.解封角色禁言接口
+
+​      请求数据
+
+​		
+
+| 字段        | 是否必传 | 字段类型 |                                           |      |
+| ----------- | -------- | -------- | ----------------------------------------- | ---- |
+| cp_role_id  | 是       | String   | 角色ID                                    |      |
+| game_id     | 否       | int      | 创角游戏ID                                |      |
+| zw_number   | 是       | int      | 1 2 3 4  例如掌玩1                        |      |
+| banned_type | 是       | int      | 封禁方式 ：     1  禁言角色    3 静默禁言 |      |
+| server_id   | 是       | String   | 角色注册区服ID                            |      |
+| player_id   | 是       | string   | 登录账号返回信息  唯一信息  确定账号      |      |
+
+
+
+返回数据
+
+|      | 是否必要 | 字段类型 |                               |
+| ---- | -------- | -------- | ----------------------------- |
+| code | 是       | int      | 1 成功  2 失败                |
+| msg  | 是       | string   | 返回信息  ： 解封角色禁言成功 |
+
+ 
+
+
+
+#### 3.封角色、 账号 接口 
+
+请求数据
+
+| 字段        | 是否必传 | 字段类型 |                                      |      |
+| ----------- | -------- | -------- | ------------------------------------ | ---- |
+| cp_role_id  | 是       | String   | 角色ID                               |      |
+| banned_type | 是       | int      | 1 封角色  2 封账号  默认封角色       |      |
+| server_id   | 是       | String   | 角色注册区服ID                       |      |
+| game_id     | 否       | int      | 创角游戏ID                           |      |
+| zw_number   | 是       | int      | 1 2 3 4  例如掌玩1                   |      |
+| player_id   | 是       | string   | 登录账号返回信息  唯一信息  确定账号 |      |
+
+
+
+返回数据
+
+|      | 是否必要 | 字段类型 |                           |
+| ---- | -------- | -------- | ------------------------- |
+| code | 是       | int      | 1 成功  2 失败            |
+| msg  | 是       | string   | 返回信息  ： 封禁角色成功 |
+
+#### 4.解封角色、 账号 接口
+
+​      请求数据
+
+​		
+
+| 字段        | 是否必传 | 字段类型 |                                      |      |
+| ----------- | -------- | -------- | ------------------------------------ | ---- |
+| cp_role_id  | 是       | String   | 角色ID                               |      |
+| banned_type | 是       | int      | 1 封角色  2 封账号  默认封角色       |      |
+| game_id     | 否       | int      | 创角游戏ID                           |      |
+| zw_number   | 是       | int      | 1 2 3 4  例如掌玩1                   |      |
+| server_id   | 是       | String   | 角色注册区服ID                       |      |
+| player_id   | 是       | string   | 登录账号返回信息  唯一信息  确定账号 |      |
+
+
+
+返回数据
+
+|      | 是否必要 | 字段类型 |                           |
+| ---- | -------- | -------- | ------------------------- |
+| code | 是       | int      | 1 成功  2 失败            |
+| msg  | 是       | string   | 返回信息  ： 解封角色成功 |
+
+ 
\ No newline at end of file