(以“{{api_desc_v2| uri=messages/subscribers/ids| desc=获取订阅用户ID列表| httpMethod=GET| needAuth=是| level={{Api_L1}}| rateLimit=是| params= {{api_args|uid|f...”为内容创建页面) |
|||
第8行: | 第8行: | ||
params= | params= | ||
{{api_args|uid|false|int64|指定V用户的ID,默认不填为当前登录用户ID。}} | {{api_args|uid|false|int64|指定V用户的ID,默认不填为当前登录用户ID。}} | ||
− | {{api_args|count|false|int| | + | {{api_args|count|false|int|返每页返回的最大记录数,最大不能超过5000,默认为500。}} |
− | {{api_args| | + | {{api_args|start_time|false|int64|从哪个订阅时间戳(单位毫秒)开始向后取,与count参数搭配使用,通过增加或减少start_time值来获取更多数据。返回结果中会得到next_time字段,表示下一页的start_time。next_time为0表示已经到记录末尾。默认不传为-1表示从当前时间戳开始。}} |
| | | | ||
apiToolPara=key1=uid&value1=1870632073| | apiToolPara=key1=uid&value1=1870632073| | ||
第18行: | 第18行: | ||
{ | { | ||
"ids": [ | "ids": [ | ||
− | + | 1902538057, | |
− | 2731569005 | + | 2731569005 |
− | + | ||
], | ], | ||
− | "total_number": 139 | + | "next_time": 1386555310, //表示下一页开始的时间戳,返回0时表示下一页已无数据 |
+ | "current_time": 1386783297, //表示本次的start_time值 | ||
+ | "total_number": 139 //总订阅用户数 | ||
} | } | ||
// 失败返回 | // 失败返回 | ||
{ | { | ||
− | + | "request": "/2/messages/subscribers/ids.json", | |
− | + | "error_code": 264XX, | |
− | + | "error": "error message." | |
} | } | ||
</pre>| | </pre>| |
2013年12月25日 (三) 14:26的版本
messages/subscribers/ids
获取订阅用户ID列表
URL
https://api.weibo.com/2/messages/subscribers/ids.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
uid | false | int64 | 指定V用户的ID,默认不填为当前登录用户ID。 |
count | false | int | 返每页返回的最大记录数,最大不能超过5000,默认为500。 |
start_time | false | int64 | 从哪个订阅时间戳(单位毫秒)开始向后取,与count参数搭配使用,通过增加或减少start_time值来获取更多数据。返回结果中会得到next_time字段,表示下一页的start_time。next_time为0表示已经到记录末尾。默认不传为-1表示从当前时间戳开始。 |
注意事项
- 1,当指定的uid不是当前登录用户时:
- 当前登录用户必须为当前应用的所有者;
- 2,指定的uid用户已指定当前应用为其开发,且指定的uid用户已开启“开发模式”;
调用样例及调试工具
返回结果
JSON示例
// 成功返回 { "ids": [ 1902538057, 2731569005 ], "next_time": 1386555310, //表示下一页开始的时间戳,返回0时表示下一页已无数据 "current_time": 1386783297, //表示本次的start_time值 "total_number": 139 //总订阅用户数 } // 失败返回 { "request": "/2/messages/subscribers/ids.json", "error_code": 264XX, "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
到 帮助中心 查看更多问题或提问