v3/user/get_multi_info

目录

What's New?

2012年12月07日,本接口新增返回参数“is_yellow_high_vip”,用于判断用户是否为豪华版黄钻用户。

1 功能说明

批量获取多个用户的基本信息,包括昵称、头像等。
本接口是全平台通用的,即发送请求后,可根据请求中传入的“pf”平台参数返回对应平台的用户信息。
例如:如果传入的pf为qzone,则返回的是QQ空间的用户信息。
备注:
(1)本接口只返回安装了该应用的openid的详细信息。如果传入的fopenids中某个openid并没有安装该应用,则对应的详细信息为空。
(2)每次最多可返回100个用户的信息。

2 接口调用说明

2.1 URL

http://[域名]/v3/user/get_multi_info

正式环境域名或测试环境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列表,中间以_隔开,每次最多100个。

注意如果使用GET方式传100个openid是超过2048字节限制的,所以如果需要传100个openid请使用POST方法。

2.6 请求示例

http://113.108.20.23/v3/user/get_multi_info?
openid=08B8273AAAABE0D9F84CAB4E8888DAA0&
openkey=9999996917C28878F66F28E7F16B7F89E7E752D589B8B261&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=qzone&
format=json&
userip=112.90.139.30&
fopenids=08B9999CACFBE0D9F57CAB4E7D8BDBF0_83A390F6A8E66BA800829ECD6032A6DE

2.7 返回参数说明

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

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

openid 好友QQ号码转化得到的ID。
nickname 昵称。
figureurl 头像URL。详见:前端页面规范#6. 关于用户头像的获取和尺寸说明
is_yellow_vip 是否为黄钻用户(0:不是; 1:是)。
is_yellow_year_vip 是否为年费黄钻用户(0:不是; 1:是)。
yellow_vip_level 黄钻等级(如果是黄钻用户才返回此字段)。
is_yellow_high_vip 是否为豪华版黄钻用户(0:不是; 1:是)。

(当pf=qzone、pengyou或qplus时返回)

gender 用户性别。
city 用户所在的城市。
province 用户所在的省。
country 用户所在的国家。
qplus_level 用户在Q+平台的等级(仅当pf=qplus时返回)。
qq_online_stat 判断用户QQ在线状态(0:不在线; 1:在线)。

(仅当pf=qplus时返回)

qplus_online_stat 判断用户Q+在线状态(0:不在线; 1:在线)。

(仅当pf=qplus时返回)

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"is_lost":0,
"items":[
{
"openid":"08B9999CACFBE0D9F57CAB4E7D8BDBF0",
"nickname":"Jane",
"figureurl":"http://imgcache.qq.com/qzone_v4/client/userinfo_icon/11111111.gif",
"is_yellow_vip":1,
"is_yellow_year_vip": 1,
"yellow_vip_level": 1,
"is_yellow_high_vip": 0
},
{
"openid":"83A390F6A8E66BA800829ECD6032A6DE",
"nickname":"Jim",
"figureurl":"http://imgcache.qq.com/qzone_v4/client/userinfo_icon/22222222.gif",
"is_yellow_vip":1,
"is_yellow_year_vip": 1,
"yellow_vip_level": 1,
"is_yellow_high_vip": 0
}
]
}

2.9 错误返回示例

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

3 示例代码

详见:SDK下载#OpenAPI V3.0 SDK下载

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部