蓝钻接入API列表
5.7 /v3/user/get_multi_info
返回指定用户的基本信息
5.7.1 URL
//[域名/IP]/v3/user/get_multi_info
5.7.2 格式
JSON
5.7.3 HTTP请求方式
GET,POST
5.7.4 IP限制
TRUE
5.7.5 输入参数说明
参数 | 类型 | 含义 | 可选/必选 |
---|---|---|---|
appid | int | 详见公共参数说明部分 | 必选 |
openid | string | 详见公共参数说明部分 | 必选 |
openkey | string | 详见公共参数说明部分 | 必选 |
ids | string | 指定的用户ID | 必选 |
sig | string | 详见公共参数说明部分 | 必选 |
pf | string | 详见公共参数说明部分 | 必选 |
seq | int | 回传字段 | 可选 |
5.7.6 请求事例
//113.108.20.23/user/get_multi_info?
openid=0000000000000000000000000079F53D&
openkey=BC78A8A0DF9CDEC0D5D96174831FF3CB&
appid=29137&pf=qqgame&ids=0000000000000000000000000079F53D_0000000000000000000000004D0F0CCF&
sig=ZFHY%2FPp9lnTRXAXgu6IaqaCOwJg%3D
openid=0000000000000000000000000079F53D&
openkey=BC78A8A0DF9CDEC0D5D96174831FF3CB&
appid=29137&pf=qqgame&ids=0000000000000000000000000079F53D_0000000000000000000000004D0F0CCF&
sig=ZFHY%2FPp9lnTRXAXgu6IaqaCOwJg%3D
返回参数说明
参数 | 类型 | 含义 |
---|---|---|
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 | 所在城市,取不到则返回空 |
5.7.7 正确返回示例
{"ret":0,"msg":"操作成功",
"uin":0,"is_lsot":0,
"infos":
[{"id":"0000000000000000000000000079F53D",
"nickname":"hello world",
"figureurl":"//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":"//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":"武汉"}]}
"uin":0,"is_lsot":0,
"infos":
[{"id":"0000000000000000000000000079F53D",
"nickname":"hello world",
"figureurl":"//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":"//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":"武汉"}]}
5.7.8 错误返回示例
参见公共错误返回示例