C/2/datapush/edit/en
(以“{{Api_desc_business_en| uri=datapush/edit| desc=Subscribe keywords and users.| httpMethod=POST| needAuth=False| rateLimit={{B_rate_limit_en}}| params={{api_args|subi...”为内容创建页面) |
|||
(未显示1个用户的2个中间版本) | |||
第8行: | 第8行: | ||
{{api_args|add_keywords|false|string|Add keywords that will be subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call.}} | {{api_args|add_keywords|false|string|Add keywords that will be subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call.}} | ||
{{api_args|del_keywords|false|string|Delete keywords that have already been subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call.}} | {{api_args|del_keywords|false|string|Delete keywords that have already been subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call.}} | ||
− | {{api_args| | + | {{api_args|add_uids|false|string|Add userids that will be subscribed. The userids should be separated by semiangle comma, and are limited by 50 userids per call.}} |
− | {{api_args| | + | {{api_args|del_uids|false|string|Delete userids that have already been subscribed. The userids should be separated by semiangle comma, and are limited by 50 userids per call.}} |
| | | | ||
result= | result= | ||
第15行: | 第15行: | ||
//Success | //Success | ||
{ | { | ||
− | + | "result":true | |
− | + | } | |
− | + | //or | |
− | + | { | |
− | + | "appkey": 2363923368"subid": 10032"subname": "JY测试1""ip": [ | |
− | + | 10.210.xx, | |
− | + | 10.210.230.xx, | |
− | + | ..... | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | ... | + | |
], | ], | ||
− | + | "filters": { | |
+ | "userfilter": { | ||
+ | "id": [ | ||
+ | 1231456, | ||
+ | 1234564565 | ||
+ | ] | ||
+ | }, | ||
+ | "domainfilter": { | ||
+ | "domain": [ | ||
+ | "www.baidu.com", | ||
+ | "www.sina.com" | ||
+ | ] | ||
+ | }, | ||
+ | "mediafilter": { | ||
+ | "video": true, | ||
+ | "pic": false, | ||
+ | "music": false, | ||
+ | "ori": true | ||
+ | }, | ||
+ | "keywordfilter": { | ||
+ | "key": [ | ||
+ | "hello", | ||
+ | "world" | ||
+ | ], | ||
+ | |||
+ | }, | ||
+ | "appfilter": { | ||
+ | "currentapp": "true" | ||
+ | }, | ||
+ | "datafilter": { | ||
+ | "weibo": true, | ||
+ | "comment": false | ||
+ | } | ||
+ | }, | ||
+ | "strategy": { | ||
+ | "pushstatus": "true/false", | ||
+ | "begintime": "", | ||
+ | "endtime": "", | ||
+ | "percent": "", | ||
+ | |||
+ | } | ||
} | } | ||
+ | |||
//Failure | //Failure | ||
{ | { |
2013年10月25日 (五) 16:22的最后版本
datapush/edit
Subscribe keywords and users.
URL
https://c.api.weibo.com/2/datapush/edit.json
Supported Formats
JSON
HTTP Request Method
POST
Requires Login
False
See the Login and Authorization Mechanism Statement for login and authorization details.
Requests Count Limitation
Request all APIs:
- 50000/hour/IP;
- 50000/hour/IP;
Request Parameters
Requires | Type and Range | Description | |
---|---|---|---|
source | false | string | This parameter is not needed when using OAuth.The value of this parameter is the AppKey. |
access_token | false | string | This parameter is required when using OAuth.You will get the access_token after oauth authorization. |
subid | true | int | Subscription ID (See the specification for more information). |
add_keywords | false | string | Add keywords that will be subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call. |
del_keywords | false | string | Delete keywords that have already been subscribed. The keywords should be separated by semiangle comma, and are limited by 20 keywords per call. |
add_uids | false | string | Add userids that will be subscribed. The userids should be separated by semiangle comma, and are limited by 50 userids per call. |
del_uids | false | string | Delete userids that have already been subscribed. The userids should be separated by semiangle comma, and are limited by 50 userids per call. |
Notes
- If just parameter ‘subid’ is passed, the subscription info included the keywords and users list will be returned.
- 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.
- Parameter 'source' and 'access_token' are not needed to pass.
Response
JSON Example
//Success { "result":true } //or { "appkey": 2363923368"subid": 10032"subname": "JY测试1""ip": [ 10.210.xx, 10.210.230.xx, ..... ], "filters": { "userfilter": { "id": [ 1231456, 1234564565 ] }, "domainfilter": { "domain": [ "www.baidu.com", "www.sina.com" ] }, "mediafilter": { "video": true, "pic": false, "music": false, "ori": true }, "keywordfilter": { "key": [ "hello", "world" ], }, "appfilter": { "currentapp": "true" }, "datafilter": { "weibo": true, "comment": false } }, "strategy": { "pushstatus": "true/false", "begintime": "", "endtime": "", "percent": "", } } //Failure { "request": "/statuses/bilateral_timeline/ids.json", "error_code": "201XX", "error": "error message." }
See the Error Code Description for the error information details.
Field Description
None
Others
None
文档更新时间: 2013-10-25