空间H5游戏-后台接口
/v3/user/set_achievement
pf=qzone
pf=wanba_ts
用户在应用内进行操作的过程中,等级会逐步上升。
应用可调用本接口,上传用户在应用中的等级相关信息,从而将用户的等级相关信息进行存储。
存储后,应用可调用接口v3/user/get_achievement进行查询。
注
- 开发者上传的等级信息不能为0,否则不对相关信息进行存储;
- 且上传的等级信息必须比之前上传的等级高,否则保持之前那条等级信息的等级与时间戳不变。
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
}