空间小游戏

空间H5游戏-后台接口

/v3/user/get_gamebar_ranklist

pf=qzone pf=wanba_ts

玩吧游戏拉取游戏的排行榜列表。

URL

https://api.urlshare.cn/v3/user/get_gamebar_ranklist

私有参数

参数名称 是否必须 类型 描述
appid 是 int 应用ID
dimname 是 string 拉取纬度，类别一对应level，类别二对应key1，类别三对应key2
rank_start 否 int 拉取排行的起始位置（默认0）
pull_cnt 否 int 拉取排行的个数（最小为3，最大为50，默认3）
direction 否 int 拉取排行的方向（-1往前拉取，0向后拉取，默认0）

请求示例

https://api.urlshare.cn/v3/user/get_gamebar_ranklist?
openid=B624064BA065E01CB73F835017FE96FA&

openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&

appid=307653887&

dimname=level&

rank_start=0&

pull_cnt=10&

direction=1&

sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D&

pf=wanba_ts&

format=json&

userip=112.90.139.30

返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误，返回错误信息。
ranktips 排行榜提示文字，没有排行的时候，会输出默认的提示文字
rankcnt 排行榜总个数
selfrank 自己的排名
selfrank_score 自己的积分
selfrank_top_score 自己历史最高积分
ranklist 排行榜列表
openid 好友的openid
rank 好友的排名
score 好友的分数
topscore 好友的历史最高积分

错误返回码说明

本接口私有错误返回码：

  • 2000:openid无效
  • 2001:服务器响应错误

正确返回示例

{
"ret":0,
"msg":"操作成功",
"ranktips":"",
"rankcnt":11,
"selfrank":2,
"selfrank_score":3435,
"selfrank_top_score":3435,
"ranklist":[
    {"openid":"07732C00DB4EF623371C8B409616A430",
        "rank":1,
        "score":10000,
        "topscore":10000,
        "avatar":"http://thirdapp2.qlogo.cn/qzopenapp/817afe2e6f5f55c570d6db33764234aa4840e5c182363657a5daafd03744ea3a/50",
        "nick":"aa"},
    {"openid":"BE2BDDE2BB01298875F756814C253AC5",
        "rank":2,
        "score":1000,
        "topscore":1000,
        "avatar":"http://thirdapp3.qlogo.cn/qzopenapp/9a39e278ce662d46b4f1f5f46d78821c502bc23594a59daff36605f0177f1ee2/50",
        "nick":"bb"},
    {"openid":"6F0DFEC0A8EE63A5B70DF62C76418A55",
        "rank":3,
        "score":100,
        "topscore":100
    }]
}