跳转到: 导航, 搜索
第17行: 第17行:
 
=Filters=
 
=Filters=
  
<font size="2" style="font-weight:bold">订阅用户:</font>
+
<font size="2" style="font-weight:bold">●      Push according to data types:</font>
  
开发者可最多指定10000个用户。当订阅微博时,微博为指定用户发出的,则推送;当订阅评论时,评论对应的微博为指定用户产生的评论则推送;若不指定,则无此限制。
+
Either statuses or comments can be subscribed. A subscription can’t subscribe both of them. Default are statuses.
  
  
<font size="2" style="font-weight:bold">订阅关键词:</font>
+
<font size="2" style="font-weight:bold">● Push according to users:</font>
  
开发者可最多指定400个关键词。当订阅微博时,微博中含有指定关键词的,则推送;当订阅评论时,评论对应的微博含有此关键词的评论则推送;若不指定,则无此限制。
+
The max number is up to 10000 userids for each subscription. When subscribe for statuses, statuses created by the users specified will be delivered. When subscribe for comments, the statuses which are created by the users specified, the comments to the statuses will be delivered.
  
  
<font size="2" style="font-weight:bold">订阅域名:</font>
+
<font size="2" style="font-weight:bold">● Push according to keywords:</font>
  
开发者可最多指定20个域名。当订阅微博时,微博中包含短链所对应原始链接为指定域名下的,则推送;当订阅评论时,评论对应的微博内包含短链所对应原始链接为指定域名的评论则推送;若不指定,则无此限制。
+
The max number is up to 400 keywords for each subscription. When subscribe for statuses, statuses which contain one of the keywords specified will be delivered. When subscribe for comments, the statuses which are commented contain one of the keywords specified, the comments will be delivered.
  
  
<font size="2" style="font-weight:bold">订阅应用:</font>
+
<font size="2" style="font-weight:bold">● Push according to domains:</font>
  
开发者可指定只推送生成订阅的应用产生的数据,若不指定则推送所有应用的数据。
+
The max number is up to 20 domains for each subscription. When subscribe for statuses, statuses which contain the short links that one of the short links which original link contain one of the domains specified will be delivered. When subscribe for comments, the statuses which are commented contain the short links that one of the short links which original link contain one of the domains specified, the comments will be delivered.
  
  
<font size="2" style="font-weight:bold">订阅媒体类型:</font>
+
<font size="2" style="font-weight:bold">● Push according to applications:</font>
  
当订阅微博时,才可以指定该条件。开发者可指定原创、转发、视频、音乐、或图片类型。则推送指定类型的微博;若不指定,则无此限制;当订阅评论时,无此筛选条件。
+
The application can only be delivered the statuses or comments which were created by the application itself. Or be delivered the datas created by all the applications on Weibo Platform.
  
  
<font size="2" style="font-weight:bold">订阅数据类型:</font>
+
<font size="2" style="font-weight:bold">● Push according to media types:</font>
  
开发者可指定推送微博、或评论数据;若不指定,则默认推送微博。
+
Only when the statuses are subscribed is the filter valid. There are five media types: ‘original’, ‘repost’, ‘video, ‘music’, ‘picture’. The statuses which fit the media types specified will be delivered.
  
  
<font size="2" style="font-weight:bold">订阅百分比:</font>
+
<font size="2" style="font-weight:bold">● Push according to percentage specified:</font>
  
开发者可指定满足以上订阅条件的数据的百分比,若不指定,则推送满足条件的1%数据。
+
The datas of a percentage of the full datas that fit all the filters above will be delivered. Default is 1 percent.
  
  
<font size="2" style="font-weight:bold">订阅时间范围:</font>
+
<font size="2" style="font-weight:bold">● Push according to time range specified:</font>
  
开发者可指定推送开始时间和结束时间。在指定开始时间推送服务准备就绪,结束时间终止推送。若不指定,则开始时间默认等于订阅生成时间,一直推送。在推送服务准备就绪时,开发者可以调用接口进行连接,从而接收数据。具体连接方法请见下方介绍。
+
Applications can specify the start time and the end time of the pushing. Pushing server will be ready when arrives at the start time. And the pushing will be terminated when arrives at the end time. If not specified, the start time is equal the time the subscription was created. And the pushing has no end. When the pushing server is ready, applications can connect the pushing APIs to get the datas. See the followings for the specification.
  
  

2013年10月9日 (三) 16:19的版本

目录

Overview

The subscription service of Weibo Platform makes the applications get the datas more efficiently. According to the subscription filters like keywords, users, and domains applications specified, the applications will be delivered the new datas that match the filters in real-time by the Weibo Platform, without needing to poll the APIs as before.


Advantages:

● The datas are for the real-time.

● Save the network resources.

● Provide the more full datas.

● Get the datas more efficiently.


Filters

● Push according to data types:

Either statuses or comments can be subscribed. A subscription can’t subscribe both of them. Default are statuses.


● Push according to users:

The max number is up to 10000 userids for each subscription. When subscribe for statuses, statuses created by the users specified will be delivered. When subscribe for comments, the statuses which are created by the users specified, the comments to the statuses will be delivered.


● Push according to keywords:

The max number is up to 400 keywords for each subscription. When subscribe for statuses, statuses which contain one of the keywords specified will be delivered. When subscribe for comments, the statuses which are commented contain one of the keywords specified, the comments will be delivered.


● Push according to domains:

The max number is up to 20 domains for each subscription. When subscribe for statuses, statuses which contain the short links that one of the short links which original link contain one of the domains specified will be delivered. When subscribe for comments, the statuses which are commented contain the short links that one of the short links which original link contain one of the domains specified, the comments will be delivered.


● Push according to applications:

The application can only be delivered the statuses or comments which were created by the application itself. Or be delivered the datas created by all the applications on Weibo Platform.


● Push according to media types:

Only when the statuses are subscribed is the filter valid. There are five media types: ‘original’, ‘repost’, ‘video, ‘music’, ‘picture’. The statuses which fit the media types specified will be delivered.


● Push according to percentage specified:

The datas of a percentage of the full datas that fit all the filters above will be delivered. Default is 1 percent.


● Push according to time range specified:

Applications can specify the start time and the end time of the pushing. Pushing server will be ready when arrives at the start time. And the pushing will be terminated when arrives at the end time. If not specified, the start time is equal the time the subscription was created. And the pushing has no end. When the pushing server is ready, applications can connect the pushing APIs to get the datas. See the followings for the specification.


Steps

Specifications

Keyword & User Subscription

Statuses