C/2/datapush/status

跳转到: 导航, 搜索
第7行: 第7行:
 
params={{api_args|subid|true|int|订阅ID([[详情]])。}}
 
params={{api_args|subid|true|int|订阅ID([[详情]])。}}
 
{{api_args|since_id|false|long|上次连接断开时的数据ID。保存断开后五分钟内的数据,可以通过since_id获取断开五分钟内的数据。}}
 
{{api_args|since_id|false|long|上次连接断开时的数据ID。保存断开后五分钟内的数据,可以通过since_id获取断开五分钟内的数据。}}
 +
{{api_args|interval|false|int|0:表示实时推送;1:表示推送中断后3小时内数据,默认值为0}}
 
|
 
|
 
result=
 
result=
第43行: 第44行:
 
*请求该接口的IP必须在此订阅的IP白名单中,否则无法请求该接口;
 
*请求该接口的IP必须在此订阅的IP白名单中,否则无法请求该接口;
 
*该接口不需要登录认证,不需要传入source、access_token参数;
 
*该接口不需要登录认证,不需要传入source、access_token参数;
*数据id是接口返回数据的第一行,不是status字段里的微博id; |
+
*数据id是接口返回数据的第一行,不是status字段里的微博id;
 +
*断开五分钟内的数据无需使用interval参数 |
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2016年12月16日 (五) 16:59的版本

datapush/status

调用该接口进行连接,接收微博数据。

URL

https://c.api.weibo.com/2/datapush/status.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录

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

访问授权限制


请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
subid true int 订阅ID(详情)。
since_id false long 上次连接断开时的数据ID。保存断开后五分钟内的数据,可以通过since_id获取断开五分钟内的数据。
interval false int 0:表示实时推送;1:表示推送中断后3小时内数据,默认值为0

注意事项

  • 请使用url: http://c.api.weibo.com/datapush/status 请求该接口。url: https://c.api.weibo.com/2/datapush/status.json 暂不支持;
  • 请求该接口的IP必须在此订阅的IP白名单中,否则无法请求该接口;
  • 该接口不需要登录认证,不需要传入source、access_token参数;
  • 数据id是接口返回数据的第一行,不是status字段里的微博id;
  • 断开五分钟内的数据无需使用interval参数

返回结果

JSON示例

{
    "id": 1211260020031346,
    "text": {
        "type": "status",
        "event": "add",
        "status": {
            "created_at": "Mon Nov 26 10:25:38 +0800 2012",
            "id": 3516560159321035,
            "text": "百度新闻 http://t.cn/zjbRppQ (分享自@百度手机浏览器)",
            "source": "<a href=\"http://m.weibo.com/web/cellphone.php#android\" rel=\"nofollow\">Android客户端</a>",
            "favorited": false,
            "truncated": false,
            "in_reply_to_status_id": "",
            "in_reply_to_user_id": "",
            "in_reply_to_screen_name": "",
            "geo": null,
            "mid": "3516560159321035",
            "isLongText":false,     //当为true时,表示博文内容超过140字
            "user": {
                …
            }
            
        }
    },
    "match_info":{             //匹配信息
        "keyword":"不是",    //匹配上的关键词
        "uid":0              //匹配上的用户ID
    }
}

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

字段说明

其他



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


api评价