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 } }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无