空间H5游戏-后台接口

/v3/user/set_achievement

pf=qzone pf=wanba_ts

用户在应用内进行操作的过程中,等级会逐步上升。

应用可调用本接口,上传用户在应用中的等级相关信息,从而将用户的等级相关信息进行存储。

存储后,应用可调用接口v3/user/get_achievement进行查询。

  1. 开发者上传的等级信息不能为0,否则不对相关信息进行存储;
  2. 且上传的等级信息必须比之前上传的等级高,否则保持之前那条等级信息的等级与时间戳不变。

URL

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

私有参数

参数名称 是否必须 类型 描述
user_attr 必须 json格式 要上传的用户属性信息,只有上传的字段会更新,可上传的字段包括:
level:用户等级。格式为uint。
例如: {"level":10}

排行榜纬度对应关系

纬度 key 描述
类别一 level 用户等级排行
类别二 key1 自定义排行
类别三 key2 自定义排行

请求示例

https://api.urlshare.cn/v3/user/set_achievement?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
pf=wanba_ts&
format=json&
userip=112.90.139.30&
user_attr=%7B%22level%22%3A10%7D&
sig=9999b41ad0b688530bb1b21c5957391c

返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。
0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

正确返回示例

{
  "ret":0,
  "is_lost":0
}