(创建新页面为 '{{api_desc_v2| uri=users/show_batch| desc=批量获取用户的基本信息| httpMethod=GET| needAuth=是| level={{Api_L1}}| rateLimit=是| params={{api_args|uids|true|string|…') |
|||
| 第10行： | 第10行： | ||
result= | result= | ||
<pre> | <pre> | ||
| − | ... | + | { |
| + | "users": [ | ||
| + | { | ||
| + | "id": 1404376560, | ||
| + | "screen_name": "zaku", | ||
| + | "name": "zaku", | ||
| + | "province": "11", | ||
| + | "city": "5", | ||
| + | "location": "北京 朝阳区", | ||
| + | "description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。", | ||
| + | "url": "http://blog.sina.com.cn/zaku", | ||
| + | "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", | ||
| + | "domain": "zaku", | ||
| + | "gender": "m", | ||
| + | "followers_count": 1204, | ||
| + | "friends_count": 447, | ||
| + | "statuses_count": 2908, | ||
| + | "favourites_count": 0, | ||
| + | "created_at": "Fri Aug 28 00:00:00 +0800 2009", | ||
| + | "following": false, | ||
| + | "allow_all_act_msg": false, | ||
| + | "geo_enabled": true, | ||
| + | "verified": false, | ||
| + | "status": { | ||
| + | "created_at": "Tue May 24 18:04:53 +0800 2011", | ||
| + | "id": 11142488790, | ||
| + | "text": "我的相机到了。", | ||
| + | "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", | ||
| + | "favorited": false, | ||
| + | "truncated": false, | ||
| + | "in_reply_to_status_id": "", | ||
| + | "in_reply_to_user_id": "", | ||
| + | "in_reply_to_screen_name": "", | ||
| + | "geo": null, | ||
| + | "mid": "5610221544300749636", | ||
| + | "annotations": [], | ||
| + | "reposts_count": 5, | ||
| + | "comments_count": 8, | ||
| + | }, | ||
| + | "allow_all_comment": true, | ||
| + | "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", | ||
| + | "verified_reason": "", | ||
| + | "follow_me": false, | ||
| + | "online_status": 0, | ||
| + | "bi_followers_count": 215 | ||
| + | }, | ||
| + | ... | ||
| + | ], | ||
| + | "total_number": 10, | ||
| + | "states": [ | ||
| + | { | ||
| + | "id": 1404376560, | ||
| + | "state": 1 | ||
| + | }, | ||
| + | ... | ||
| + | ] | ||
| + | } | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
| − | useAge= | + | useAge=参数uid与screen_name二者必选其一，且只能选其一| |
otherInfo=无 | otherInfo=无 | ||
}} | }} | ||
2011年5月31日 (二) 16:23的版本
users/show_batch
批量获取用户的基本信息
URL
https://api.weibo.com/2/users/show_batch.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
| uids | true | string | 需要查询的用户ID，用半角逗号分隔，一次最多20个。 |
| screen_name | false | string | 需要查询的用户昵称，用半角逗号分隔，一次最多20个。 |
注意事项
参数uid与screen_name二者必选其一，且只能选其一
调用样例及调试工具
返回结果
JSON示例
{
"users": [
{
"id": 1404376560,
"screen_name": "zaku",
"name": "zaku",
"province": "11",
"city": "5",
"location": "北京 朝阳区",
"description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
"url": "http://blog.sina.com.cn/zaku",
"profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
"domain": "zaku",
"gender": "m",
"followers_count": 1204,
"friends_count": 447,
"statuses_count": 2908,
"favourites_count": 0,
"created_at": "Fri Aug 28 00:00:00 +0800 2009",
"following": false,
"allow_all_act_msg": false,
"geo_enabled": true,
"verified": false,
"status": {
"created_at": "Tue May 24 18:04:53 +0800 2011",
"id": 11142488790,
"text": "我的相机到了。",
"source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
"favorited": false,
"truncated": false,
"in_reply_to_status_id": "",
"in_reply_to_user_id": "",
"in_reply_to_screen_name": "",
"geo": null,
"mid": "5610221544300749636",
"annotations": [],
"reposts_count": 5,
"comments_count": 8,
},
"allow_all_comment": true,
"avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
"verified_reason": "",
"follow_me": false,
"online_status": 0,
"bi_followers_count": 215
},
...
],
"total_number": 10,
"states": [
{
"id": 1404376560,
"state": 1
},
...
]
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
