2. 角色查询 (必选)
2.1 角色列表 (必选)
- action:
roleList - 根据平台用户ID查询角色列表
请求data
| 参数 | 类型 | 描述 |
|---|
| channelId | int | 渠道ID (可选) |
| userId | String | 平台用户ID |
{"data":"{\"userId\":\"4000001\",\"channelId\":6001}","sign":"this is sign string","action":"roleList","ts":1234567890}
响应data
| 参数 | 类型 | 描述 |
|---|
| channelId | int | 角色创建时所在包的渠道ID |
| userId | String | 平台用户ID |
| serverId | String | 服务器ID |
| serverName | String | 服务器名称 |
| roleId | String | 角色ID |
| roleName | String | 角色名称 |
| originServerId | String | 角色创建服务器ID |
| originServerName | String | 角色创建服务器名称 |
| level | int | 角色等级 |
| power | int | 角色战力 |
| vipLevel | int | VIP等级 |
| recharge | int | 充值金额，单位分 |
| online | int | 是否在线（1在线，0离线） |
| loginTime | long | 最后登录时间，Unix时间戳秒 |
| createTime | long | 角色创建时间，Unix时间戳秒 |
| ip | String | 最后登录IP地址 |
{"msg":"success","code":1000,"data":[{"level":10,"roleId":"10010001","ip":"127.0.0.1","serverName":"S1-XXXX","originServerName":"S1-XXXX","userId":"4000001","serverId":"1001","vipLevel":1,"loginTime":1234567890,"createTime":1234567890,"recharge":600,"roleName":"XXXXXX","online":1,"originServerId":"1001","channelId":6001},{"level":8,"roleId":"10010002","ip":"127.0.0.1","serverName":"S1-XXXX","originServerName":"S1-XXXX","userId":"4000002","serverId":"1001","vipLevel":2,"loginTime":1234567890,"recharge":1200,"roleName":"YYYYYY","online":0,"originServerId":"1001","channelId":6001}]}
2.2 角色详情 (必选)
- action:
roleInfo - 根据角色ID查询角色详细信息
请求data
| 参数 | 类型 | 描述 |
|---|
| type | int | 查询类型（固定传 1，按角色ID查询） |
| keyword | String | 角色ID |
{"data":"{\"type\":\"1\",\"keyword\":\"10010001\"}","sign":"this is sign string","action":"roleInfo","ts":1234567890}
响应data
| 参数 | 类型 | 描述 |
|---|
| channelId | int | 角色创建时所在包的渠道ID |
| userId | String | 平台用户ID |
| serverId | String | 服务器ID |
| serverName | String | 服务器名称 |
| roleId | String | 角色ID |
| roleName | String | 角色名称 |
| originServerId | String | 角色创建服务器ID |
| originServerName | String | 角色创建服务器名称 |
| level | int | 角色等级 |
| power | int | 角色战力 |
| vipLevel | int | VIP等级 |
| recharge | int | 充值金额，单位分 |
| online | int | 是否在线（1在线，0离线） |
| loginTime | long | 最后登录时间，Unix时间戳秒 |
| createTime | long | 角色创建时间，Unix时间戳秒 |
| ip | String | 最后登录IP地址 |
{"msg":"success","code":1000,"data":{"level":10,"roleId":"10010001","ip":"127.0.0.1","serverName":"S1-XXXX","originServerName":"S1-XXXX","userId":"4000001","serverId":"1001","vipLevel":1,"loginTime":1234567890,"createTime":1234567890,"recharge":600,"roleName":"XXXXXX","online":1,"originServerId":"1001","channelId":6001}}
2.3 角色详情 (可选)
- action:
roleIdInfo - 根据角色短ID（游戏内个人信息-ID）查询角色详细信息
请求data
| 参数 | 类型 | 描述 |
|---|
| roleShortId | String | 角色短ID |
{"data":"{\"roleShortId\":\"312700280\"}","sign":"this is sign string","action":"roleIdInfo","ts":1234567890}
响应data
| 参数 | 类型 | 描述 |
|---|
| userId | String | 平台用户ID |
| serverId | String | 服务器ID |
| serverName | String | 服务器名称 |
| roleId | String | 角色ID |
| roleName | String | 角色名称 |
| originServerId | String | 角色创建服务器ID |
| originServerName | String | 角色创建服务器名称 |
| level | int | 角色等级 |
| power | int | 角色战力 |
| vipLevel | int | VIP等级 |
| recharge | int | 充值金额，单位分 |
| online | int | 是否在线（1在线，0离线） |
| loginTime | long | 最后登录时间，Unix时间戳秒 |
| createTime | long | 角色创建时间，Unix时间戳秒 |
| ip | String | 最后登录IP地址 |
{"msg":"success","code":1000,"data":{"level":10,"roleId":"10010001","ip":"127.0.0.1","serverName":"S1-XXXX","originServerName":"S1-XXXX","userId":"4000001","serverId":"1001","vipLevel":1,"loginTime":1234567890,"createTime":1234567890,"recharge":600,"roleName":"XXXXXX","online":1,"originServerId":"1001","channelId":6001}}