C/2/commercial/push
commercial/push
调用该接口保持长连接,接收微博数据和评论数据。
URL
https://c.api.weibo.com/2/commercial/push.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参数),数据id不是微博id,具体位置请见返回结果示例。 |
注意事项
- 请使用url: https://c.api.weibo.com/commercial/push 请求该接口。url: https://c.api.weibo.com/2/commercial/push.json 暂不支持;
- 请求该接口的IP必须在提交的ip地址范围内,否则无法请求该接口;
- 该接口不需要登录认证,不需要传入source、access_token参数;
- 数据id是接口返回数据的第一行,不是status或comment字段里的微博id;
- since_id参数说明:
- since_id缺省时,默认推送最近100条数据;
- 为了避免重复接收最近100条数据或漏推数据,强烈建议每次都传入since_id参数;
- 传入since_id,则推送该条数据之后新生成的数据内容;
- 可通过since_id获取近3天内(包含当天以及当天0点前72小时)的数据,若since_id对应时间为3天前或since_id不合法,since_id等同于缺省配置;
- 为了减少长连接异常断开,导致数据丢失的风险,推送服务的长连接断开策略如下:
- 长连接最长保持五分钟,连接建立五分钟后推送完数据时,推送长连接自动断开,第三方需要更新since_id再请求该接口;
- 若连续5s内无任何数据产生,推送长连接自动断开;
- java客户端建议使用示例代码获取数据,当解析单条数据异常时,必须及时更新since_id,防止重复获取数据造成不必要的损失;
- 用户设置的关键词分为两类:简单关键词,复合关键词(一个关键词内部包含"与"、"非"逻辑),目前新版订阅服务在关键词匹配时会优先匹配简单关键词,命中时会返回所有匹配的简单关键词,并且不再进行复合关键词的匹配;简单关键词未命中时,若命中复合关键词,则返回所有匹配的复合关键词。
返回结果
JSON示例
{ "id": 1703290048692333, //数据id "text": { "type": "status", "event": "add", "status": { "isLongText": false, "in_reply_to_status_id": "", "created_at": "Wed Mar 29 15:59:21 +0800 2017", "mid": "4090666516291596", "source": "<a href=\"http://app.weibo.com/t/feed/6vtZb0\" rel=\"nofollow\">微博 weibo.com</a>", "objectType": "", "is_show_bulletin": 2, "in_reply_to_screen_name": "", "similarity": "0", "in_reply_to_user_id": "", "id": 4090666516291596, "text": "2017年我是微博不是评论 http://t.cn/RXnQSQg", "state": 0, "reposts_count": 0, "favorited": false, "is_weibo_video": false, "visible": { "list_id": 0, "type": 0 }, "ad_tags": { "adv": [ "0" ] }, "truncated": false, "pic_urls": [], "pageMarkLevel": 0, "api_state": 3, "biz_feature": 0, "comments_count": 0, "source_id": 780, "user": { "friends_count": 5, "gender": "m", "allow_all_act_msg": false, "city": "8", "favourites_count": 0, "urank": 4, "description": "", "created_at": "Thu Jan 21 23:06:04 +0800 2016", "avatar_hd": "http://tva2.sinaimg.cn/crop.0.0.1002.1002.1024/006mX07Rjw8f42dg43zuej30ru0run05.jpg", "province": "11", "screen_name": "西二旗test", "id": 5835938223, "geo_enabled": true, "verified": false, "profile_image_url": "http://tva2.sinaimg.cn/crop.0.0.1002.1002.50/006mX07Rjw8f42dg43zuej30ru0run05.jpg", "verified_type": -1, "url": "", "avatar_large": "http://tva2.sinaimg.cn/crop.0.0.1002.1002.180/006mX07Rjw8f42dg43zuej30ru0run05.jpg", "pagefriends_count": 0, "statuses_count": 55, "domain": "", "followers_count": 0, "following": false, "name": "西二旗test", "location": "", "insecurity": { "sexual_content": false } } } } "match_info": { "subid": 10826, // 订阅id "keyword_flag": "status", // 匹配的关键词类型 "keyword": "[2017, 微博, 评论]" // 匹配的部分关键词 } "url":[ { "long_url":"http://www.weibo.com", //微博内容中的长链 "short_url":"http://t.cn/RXnQSQg", //微博内容中长链对应的短链 } ... ] } }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无