获取订阅者列表
(以“=获取订阅者列表= 开发者可以通过本接口来获取订阅用户uid列表,一次拉取调用最多拉取10000个关注者的uid,可以通过多次拉...”为内容创建页面) |
(→返回结果) |
||
第52行: | 第52行: | ||
{ | { | ||
"request": "/2/messages/subscribers/ids.json", | "request": "/2/messages/subscribers/ids.json", | ||
− | "error_code": | + | "error_code": 264XX, |
"error": "error message." | "error": "error message." | ||
} | } |
2014年5月4日 (日) 21:12的版本
获取订阅者列表
开发者可以通过本接口来获取订阅用户uid列表,一次拉取调用最多拉取10000个关注者的uid,可以通过多次拉取的方式来满足需求。
URL
https://api.weibo.com/2/messages/subscribers/ids.json
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
接口请求参数
参数详情:
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。 |
next_uid | false | int64 | 第一个拉取的uid,不填默认从头开始拉取。 |
注意事项
- 1、当账号的订阅者数量超过10000时,可通过填写next_uid的值,从而多次拉取列表的方式来满足需求;
具体而言,就是在调用接口时,将上一次调用得到的返回中的next_uid值,作为下一次调用中的next_uid值;
返回结果
正常情况下,微博会返回下述JSON数据包:
{ "total": 139, //总订阅用户数 "count": 2, //本次拉取的用户数,最大值为10000 "data": { "uids": [ 1649670037, 2731569005 ] }, "next_uid": "NEXT_UID" //拉取列表的后一个用户的UID }
// 失败返回
{ "request": "/2/messages/subscribers/ids.json", "error_code": 264XX, "error": "error message." }