角色信息列表查询接口
在游戏官网上,玩家可以选择进行外购虚拟货币的购买,此时需要游戏提供游戏角色信息列表,供网页调用。
请求方式
| 请求方式 | 请求地址 | 返回content-type | 请求方 | 接收方 |
|---|---|---|---|---|
| GET | {GAME_ROLELIST_QUERY_URL} |
application/json | 发行SDK服务端 | 游戏服务端 |
请求参数
| 参数名 | 是否必填 | 类型 | 签名因子? | 说明 |
|---|---|---|---|---|
| instanceKey | 是 | String | 是 | 发行SDK平台分配的游戏实例key |
| uid | 是 | String | 是 | 发行SDK平台帐号ID |
| serverId | 是 | String | 是 | 服id |
| ts | 是 | Int | 是 | 服务器时间戳(秒),请求服务器与响应服务器时间戳相差超过1小时,则返回错误 |
| sign | 是 | String | 否 | 签名 参考签名规则 |
返回结果
返回结果code值请参考返回值信息。
返回参数
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| roleId | 是 | String | 角色id |
| roleName | 是 | String | 角色名称 |
| level | 否 | String | 角色等级 |
| vipLevel | 否 | String | vip等级 |
| status | 是 | Int | 角色状态。0为封停的角色,1为正常的角色 |