返回指定用户的基本信息
1 URL
https://[域名/IP]/v3/user/get_multi_info
正式环境域名或测试环境IP详见：API3.0文档#请求URL说明。
2 格式
JSON
3 HTTP请求方式
GET,POST
4 IP限制
TRUE
5 输入参数说明
各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）公共参数
发送请求时必须传入公共参数，详见公共参数说明。
（2）私有参数
|
参数名称 |
类型 |
参数含义 |
可选/必选 |
|
ids |
string |
指定的用户ID |
必选 |
|
seq |
int |
透传字段，应用传入后，平台原样返回 |
可选 |
|
figure_type |
int |
figure_type = 0, //默认头像 figure_type = 1, //40*40头像 figure_type = 2, //40*40动态头像 figure_type = 3, //100*100头像 figure_type = 4, //140*140头像 figure_type = 5 //原图头像 |
可选 |
6 请求示例
https://119.147.19.43/v3/user/get_multi_info?openid=0000000000000000000000000079F53D&openkey=BC78A8A0DF9CDEC0D5D96174831FF3CB&appid=28240&pf=qqgame&sig=e3evlGSde+JQ0AodlAn5RoX6InA=
7 返回参数说明
|
参数名称 |
类型 |
含义 |
|
ret |
int |
详见公共返回码 |
| msg |
string |
错误描述 |
|
seq |
int |
回传字段 |
|
infos |
array |
用户信息数组 |
|
infos.id |
string |
目标用户的openid |
|
infos.gender |
int |
0为男，1为女，其他为未设定 |
|
infos.figureurl |
string |
自定义头像地址 |
|
infos.is_blue_vip |
int |
是否蓝钻，1为是，其他为不是 |
|
infos.blue_vip_level |
int |
蓝钻等级 |
|
infos.is_blue_year_vip |
int |
是否年费蓝钻，1为是，其他为不是 |
|
infos.is_super_blue_vip |
int |
是否年费豪华蓝钻，1为是，其他为不是 |
|
infos.country |
string |
所在国家(目前只支持中国) |
|
infos.province |
string |
所在省份，取不到则返回空 |
|
infos.city |
string |
所在城市，取不到则返回空 |
8 正确返回示例
{
"ret":0,"msg":"操作成功",
"uin":0,"is_lsot":0,
"infos":[
{"id":"0000000000000000000000000079F53D",
"nickname":"hello world",
"figureurl":"http://q2.qlogo.cn/g?b=qq&k=IX6fOibMoPjoO99x8TD9C8Q&s=40&t=135425963",
"is_blue_vip":1,
"is_blue_year_vip":1,
"is_super_blue_vip":0,
"blue_vip_level":3,
"gender":0,"country":"中国",
"province":"广东",
"city":"深圳"},
{"id":"0000000000000000000000004D0F0CCF",
"nickname":"psrunner",
"figureurl":"http://q4.qlogo.cn/g?b=qq&k=fsmv2s9xJKhwGD4dOuoXXA&s=40",
"is_blue_vip":0,
"is_blue_year_vip":0,
"is_super_blue_vip":0,
"blue_vip_level":0,
"gender":0,
"country":"中国",
"province":"湖北",
"city":"武汉"}
]
}
9 错误返回示例
参见公共错误返回示例