角色信息列表查询接口
在游戏官网上,玩家可以选择进行外购虚拟货币的购买,此时需要游戏提供游戏角色信息列表,供网页调用。
请求方式
请求方式 | 请求地址 | 返回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 为正常的角色 |