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...”为内容创建页面) |
|||
| 第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月17日 (四) 17:48的版本
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_users | 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_users | 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
