跳转到: 导航, 搜索

messages/subscribers/exists

批量判断订阅关系

URL

https://api.weibo.com/2/messages/subscribers/exists.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:普通接口
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
uid false int64 指定V用户的ID,默认不填为当前登录用户ID。
to_uids true string 指定等待判断订阅关系的用户id列表,多个时使用英文半角逗号符分隔,最大20。

注意事项

  • 1,当指定的uid不是当前登录用户时:
    • 当前登录用户必须为当前应用的所有者;
  • 2,指定的uid用户已指定当前应用为其开发,且指定的uid用户已开启“开发模式”;

调用样例及调试工具

API测试工具

返回结果

JSON示例

// 成功返回
{
    "to_uids": [
        {
            "id": 1514267615, // 待判断用户的 ID
            "result": 1   // 对于当前登录用户来说,待判断用户是:0:无订阅关系;1:订阅关系;2:已退订
            "created_at":"Mon Jul 16 18:09:20 +0800 2012" // 订阅时间,无订阅时间返回空
        },
        {
            "id": 1437229625, // 待判断用户的 ID
            "result": 1   // 对于当前登录用户来说,待判断用户是:0:无订阅关系;1:订阅关系;2:已退订
            "created_at":"Mon Jul 16 18:09:20 +0800 2012" // 订阅时间,无订阅时间返回空
        },
        {
            "id": 1197161814, // 待判断用户的 ID
            "result": 0   // 对于当前登录用户来说,待判断用户是:0:无订阅关系;1:订阅关系;2:已退订
            "created_at":"Mon Jul 16 18:09:20 +0800 2012" // 订阅时间,无订阅时间返回空
        },
        ...
    ]
}

// 失败返回
{
    "request": "/2/messages/subscribers/exists.json",
    "error_code": "264XX",
    "error": "error message."
}

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

返回字段说明

其他

相关问题


帮助中心 查看更多问题或提问


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




api评价