空间H5游戏-后台接口
/v3/user/get_multi_info
pf=qzonepf=wanba_ts
批量获取多个用户的基本信息，包括昵称、头像等。
本接口是全平台通用的，即发送请求后，可根据请求中传入的“pf”平台参数返回对应平台的用户信息。
例如：如果传入的pf为qzone，则返回的是QQ空间的用户信息。
空间小游戏使用pf值必须指定为
wanba_ts
备注
- 本接口只返回安装了该应用的openid的详细信息。如果传入的fopenids中某个openid并没有安装该应用，则对应的详细信息为空。
- 每次最多可返回100个用户的信息。
URL
https://api.urlshare.cn/v3/user/get_multi_info
私有参数
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| fopenids | 必须 | string | 需要获取数据的openid列表，中间以_隔开，每次最多100个。 注意如果使用GET方式传100个openid是超过2048字节限制的，所以如果需要传100个openid请使用POST方法。 |
请求示例
https://api.urlshare.cn/v3/user/get_multi_info?
openid=08B8273AAAABE0D9F84CAB4E8888DAA0&
openkey=9999996917C28878F66F28E7F16B7F89E7E752D589B8B261&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=wanba_ts&
format=json&
userip=112.90.139.30&
fopenids=08B9999CACFBE0D9F57CAB4E7D8BDBF0_83A390F6A8E66BA800829ECD6032A6DE
返回参数说明
| 参数名称 | 描述 |
|---|---|
| ret | 返回码。详见公共返回码说明#OpenAPI V3.0 返回码 |
| msg | 如果错误，返回错误信息。 |
| is_lost | 判断是否有数据丢失。如果应用不使用cache，不需要关心此参数。 0或者不返回：没有数据丢失，可以缓存。 1：有部分数据丢失或错误，不要缓存。 |
| openid | 好友QQ号码对应的openid。 |
| 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时返回） |
错误返回码说明
本接口私有错误返回码：暂无。
正确返回示例
{
"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
}
]
}