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,具体位置请见返回结果示例。

注意事项

  • 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,
            "mentions": [
                  2084126292     //微博中被@用户的uid列表,部门用户因为反垃圾或者用户设置原因不会返回
            ],
            "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",    //微博内容中长链对应的短链
          }
         ...
    ]
}

}

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

字段说明

其他



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


文档更新时间: 2018-04-12
api评价