跳转到: 导航, 搜索

messages/subscribers/ids

获取订阅用户ID列表

URL

https://m.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."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2013-12-26
api评价