跳转至

角色信息列表查询接口

在游戏官网上,玩家可以选择进行外购虚拟货币的购买,此时需要游戏提供游戏角色信息列表,供网页调用。

请求方式

请求方式 请求地址 返回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值请参考返回值信息

{
    "code": 200,
    "msg": "OK",
    "data": [
        {
            "roleId": "99080001",
            "roleName": "战士1",
            "level": "10",
            "vipLevel": "2",
            "status": 1
        },
        {
            "roleId": "99080002",
            "roleName": "射手1",
            "level": "15",
            "vipLevel": "3",
            "status": 0
        },
        ...
    ] 
}
{
    "code": 400,
    "msg": "signature error"
}

返回参数

参数名 是否必填 类型 说明
roleId String 角色id
roleName String 角色名称
level String 角色等级
vipLevel String vip等级
status Int 角色状态。0为封停的角色,1为正常的角色