v3/user/get_achievement

目录

What's New?

2013年09月09日,输入参数新增“area_name”,对于多区多服应用,可传入该参数获取指定分区中用户的等级。

1 功能说明

用户在应用内进行操作的过程中,等级会逐步上升。
调用接口v3/user/set_achievement将用户等级相关信息存储后,应用可调用本接口, 查询用户在应用中的等级相关信息,从而在应用中展现用户的等级。

接口调用限制:
本接口目前支持空间平台。

2 接口调用说明

2.1 URL

http://[IP或域名]/v3/user/get_achievement

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
fopenids 必须 string 需要获取等级的用户对应的openid列表,多个openid之间用“_”分隔,每次最多可传入50个openid。
area_name 可选 string 用户所在的分区的名称,对于多区多服应用,可传入该参数获取指定分区中用户的等级:

如果传入area_name,即可获取指定分区里的用户的等级;
如果不传area_name或者area_name为空,则获取默认的area_name的用户等级。

2.6 请求示例

http://openapi.tencentyun.com/v3/user/get_achievement?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
pf=qzone&
format=json&
userip=112.90.139.30&
fopenids=00000000000000000000000006E79B6C_00000000000000000000000006E80A5B&
area_name=test1&
sig=9999b41ad0b688530bb1b21c5957391c

2.7 返回参数说明

参数名称 描述
ret 返回码。

公共返回码详见:公共返回码说明#OpenAPI V3.0 返回码

msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

items 获取的用户等级相关信息列表。
openid 好友QQ号码转化得到的ID,与输入的openid一致。
area_name 用户所在的分区的名称,多区多服应用会返回该参数。
level 用户等级。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,   
  "is_lost":0,     
  "items":[
               {
                   "openid": "00000000000000000000000006E79B6C",
                   "area_name": "test1",
                   "level": 32
               },
               {
                   "openid": "00000000000000000000000006E80A5B",
                   "area_name": "test1",
                   "level": 5
               }
           ]   
  
} 

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
  "ret":1002,
  "msg":"请先登录" 
}

以上信息是否解决您的问题?

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部