C/2/subscribe/update subscribe/en
subscribe/update_subscribe
Subscribe keywords and users.
URL
https://c.api.weibo.com/2/subscribe/update_subscribe.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 50 keywords per call.It must be encoded by UTF-8. |
| del_keywords | false | string | Delete keywords that have already been subscribed. The keywords should be separated by semiangle comma, and are limited by 50 keywords per call.It must be encoded by UTF-8. |
| add_uids | false | string | Add users that will be subscribed. The ids or nicknames should be separated by semiangle comma, and are limited by 50 users per call.It must be encoded by UTF-8. |
| del_uids | false | string | Delete users that have already been subscribed. The ids or nicknames should be separated by semiangle comma, and are limited by 50 users per call.It must be encoded by UTF-8. |
Notes
- Use the url: https://c.api.weibo.com/subscribe/update_subscribe.json to call the API.The url: https://c.api.weibo.com/2/subscribe/update_subscribe.json is invalid.
- 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' must be passed and 'access_token' is 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
文档更新时间: 12 April 2018
