V1/user/get info

来自技术开发小组内部wiki
跳转至: 导航搜索

what's new

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

功能说明

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

URL

http://[域名]/v3/user/get_multi_info
正式环境域名或测试环境IP详见

格式

json

HTTP请求方式

GET, POST

IP限制

TRUE

输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)私有参数
参数名称 是否必须 类型 描述
fopenids 必须 string 需要获取数据的openid列表,中间以_隔开,每次最多100个。注意如果使用GET方式传100个openid是超过2048字节限制的,所以如果需要传100个openid请使用POST方法。

请求示例

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

返回方式说明

正确返回示例

错误返回示例

接口调用说明

示例代码