跳转到: 导航, 搜索
 
第1行: 第1行:
{{api_desc_v2|
+
{{api_desc_v2_sp|
 +
host=https://m.api.weibo.com/2/|
 
uri=messages/subscribers/exists|
 
uri=messages/subscribers/exists|
 
desc=批量判断订阅关系|
 
desc=批量判断订阅关系|
第23行: 第24行:
 
         },
 
         },
 
         {
 
         {
             "id": 1437229625, // 待判断用户的 ID
+
             "id": 1437229625,  
             "result": 1   // 对于当前登录用户来说,待判断用户是:0:无订阅关系;1:订阅关系;2:已退订
+
             "result": 1
             "created_at":"Mon Jul 16 18:09:20 +0800 2012" // 订阅时间,无订阅时间返回空
+
             "created_at":"Mon Jul 16 18:09:20 +0800 2012"  
 
         },
 
         },
 
         {
 
         {
             "id": 1197161814, // 待判断用户的 ID
+
             "id": 1197161814,  
             "result": 0  // 对于当前登录用户来说,待判断用户是:0:无订阅关系;1:订阅关系;2:已退订
+
             "result": 0   
             "created_at":"Mon Jul 16 18:09:20 +0800 2012" // 订阅时间,无订阅时间返回空
+
             "created_at":"Mon Jul 16 18:09:20 +0800 2012"  
 
         },
 
         },
 
         ...
 
         ...

2013年12月26日 (四) 15:38的最后版本

messages/subscribers/exists

批量判断订阅关系

URL

https://m.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用户已开启“开发模式”;

返回结果

JSON示例

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




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