# 角色上报与获取

**简要描述：**

- 角色上报

**请求URL：**

- `http://msl.gtarcade.com/mobilemyServers/addMyServer`

**请求方式：**

- GET/POST

**参数：**

| 参数名     | 必选 | 类型    | 说明                                     |
| :--------- | :--- | :------ | :--------------------------------------- |
| account    | 是   | string  | 平台账号                                 |
| gameId     | 是   | string  | 游戏ID                                   |
| opId       | 是   | string  | 运营商ID                                 |
| serverId   | 是   | string  | 服务器ID                                 |
| roleId     | 是   | string  | 角色ID                                   |
| roleName   | 是   | string  | 角色名                                   |
| level      | 是   | string  | 游戏等级                                 |
| job        | 是   | string  | 职业                                     |
| appId      | 是   | string  | 接口签名用appid，单独发送                |
| sign       | 是   | string  | 根据参数生成的签名                       |
| timestamp  | 是   | string  | 当前时间戳                               |
| is_mix     | 是   | string  | Android IOS是否是混服, 1:混服 0:不是混服 |
| game_op_id | 否   | integer | 游戏game opid，含义参考开服系统运维定义  |

**返回示例**

```
{    "code": 0, //code不为0均可视为失败    "msg": "success",    "data": []}
```

**返回参数说明**

| 参数名 | 类型   | 说明                            |
| :----- | :----- | :------------------------------ |
| code   | int    | 请求状态码 0，success 其它 失败 |
| msg    | string | 状态码含义                      |
| data   | array  | 返回的数据                      |

**备注**

- added by liuxy on 20180416
- 更多返回错误代码请看首页的错误代码描述

<br>

# 获取单游戏下所有角色

**简要描述：**

- 获取玩家已玩过的服务器信息

**请求URL：**

- `http://msl.gtarcade.com/mobilemyServers/index`

**请求方式：**

- GET/POST

**参数：**

| 参数名     | 必选 | 类型    | 说明                                     |
| :--------- | :--- | :------ | :--------------------------------------- |
| account    | 是   | string  | 平台账号                                 |
| gameId     | 是   | string  | 游戏ID                                   |
| opId       | 是   | string  | 运营商ID                                 |
| appId      | 是   | string  | 接口签名用appid，单独发送                |
| sign       | 是   | string  | 根据参数生成的签名                       |
| timestamp  | 是   | string  | 当前时间戳                               |
| is_mix     | 是   | string  | Android IOS是否是混服, 1:混服 0:不是混服 |
| limit      | 是   | string  | 查询条数，默认传0，返回全部              |
| game_op_id | 否   | integer | 游戏game opid，含义参考开服系统运维定义  |

**返回示例**

```
{    "code": 0,    "msg": "success",    "data": [        {            "account": "submitpaper12345",            "server_id": "22222",            "server_name": null,            "update_time": 12211211,            "socket_domain": null,            "socket_port": null,            "role_id": "2222222",            "role_name": "nickaaaa",            "level": "5",            "job": ""        },        {            "account": "submitpaper12345",            "server_id": "222221111",            "server_name": null,            "update_time": 12211211,            "socket_domain": null,            "socket_port": null,            "role_id": "2222222",            "role_name": "nickaaaa",            "level": "5",            "job": ""        },        {            "account": "submitpaper12345",            "server_id": "2222211112222",            "server_name": null,            "update_time": 12211211,            "socket_domain": null,            "socket_port": null,            "role_id": "2222222",            "role_name": "nickaaaa",            "level": "5",            "job": ""        },        {            "account": "submitpaper12345",            "server_id": "2222211112222333",            "server_name": null,            "update_time": 12211211,            "socket_domain": null,            "socket_port": null,            "role_id": "2222222",            "role_name": "nickaaaa",            "level": "5",            "job": ""        }    ]}
```

**返回参数说明**

| 参数名 | 类型   | 说明                            |
| :----- | :----- | :------------------------------ |
| code   | int    | 请求状态码 0，success 其它 失败 |
| msg    | string | 状态码含义                      |
| data   | array  | 返回的数据                      |

**备注**

- added by liuxy on 20180416
- 更多返回错误代码请看首页的错误代码描述