(→Steps) |
|||
第61行: | 第61行: | ||
Using the subscription service, there are several steps as follows: | Using the subscription service, there are several steps as follows: | ||
− | {{center|http://www.sinaimg.cn/blog/developer/wiki/subscription_en.jpg}} | + | {{center|http://www.sinaimg.cn/blog/developer/wiki/picchart/subscription_en.jpg}} |
第83行: | 第83行: | ||
If developers did not provide the start time of the pushing, the start time is equal the time the subscription was created. Pushing server will be ready when arrives at the start time. | If developers did not provide the start time of the pushing, the start time is equal the time the subscription was created. Pushing server will be ready when arrives at the start time. | ||
− | |||
− | |||
=Specifications= | =Specifications= |
2013年10月11日 (五) 19:17的版本
目录 |
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
Using the subscription service, there are several steps as follows:
![subscription_en.jpg](http://www.sinaimg.cn/blog/developer/wiki/picchart/subscription_en.jpg)
① Creates a subscription:
Developers fill out the ‘subscription service application form’ in the attachment 1, providing filters and other information. Weibo Platform will create the subscription according to the information provided in the form. Multiple subscriptions can be created for each application.
② Set subscribed keywords and users:
If ‘no’ is selected in the fields of ‘Users’ and ‘Keywords’ in ‘Paid Subscription Service Application Form’, applications need ignore this step. If ‘yes’ is selected, the keyword and user subscription list must not be empty. Call the API to subscribe keywords and users: datapush/edit
The IP address to call the API must be one of the IP list provided when created the subscription. Otherwise, the error response ‘Ip is limited’ will be returned. If just parameter ‘subid’ is passed, the subscription info included the keywords and users list will be returned.
The length of each keyword can’t exceed 12 Chinese characters. The number of keywords parameter ‘add_keywords’ specified can’t exceed 20 per request. And the number of users parameter ‘add_users’ specified can’t exceed 50 per request. The total number of keywords subscribed can’t exceed 400 for each subscription. The total number of users subscribed can’t exceed 10000 for each subscription. The keywords and users can’t be subscribed repeatedly. Weibo Platform may protect some keywords and users when needed. Protected keywords and users can’t be subscribed. If a keyword is protected, the keywords that contain the protected keyword can’t be subscribed. The keywords and the datas filtered are not case-sensitive and don’t distinguish between Simplified and Traditional Chinese.
③ Pushing server is ready:
If developers did not provide the start time of the pushing, the start time is equal the time the subscription was created. Pushing server will be ready when arrives at the start time.
Specifications
Statuses