C/2/subscribe/update subscribe
(以“{{Api_desc_business| uri=subscribe/update_subscribe| desc=订阅关键词、用户。| httpMethod=POST| needAuth=False| rateLimit={{B_rate_limit}}| params={{api_args...”为内容创建页面) |
|||
| （未显示2个用户的12个中间版本） | |||
| 第6行： | 第6行： | ||
rateLimit={{B_rate_limit}}| | rateLimit={{B_rate_limit}}| | ||
params={{api_args|subid|true|int|订阅ID（[[详情]])。}} | params={{api_args|subid|true|int|订阅ID（[[详情]])。}} | ||
| − | {{api_args|add_keywords|false|string| | + | {{api_args|add_keywords|false|string|添加要订阅的关键词，最多指定50个关键词，由英文半角逗号分隔。必须进行UTF-8编码。}} |
| − | {{api_args|del_keywords|false|string| | + | {{api_args|del_keywords|false|string|删除已订阅的关键词，最多指定50个关键词，由英文半角逗号分隔。必须进行UTF-8编码。}} |
| − | {{api_args|add_uids|false|string| | + | {{api_args|add_uids|false|string|添加要订阅的用户，最多指定50个用户ID或用户昵称，由英文半角逗号分隔。必须进行UTF-8编码。}} |
| − | {{api_args|del_uids|false|string| | + | {{api_args|del_uids|false|string|删除已订阅的用户，最多指定50个用户ID或用户昵称，由英文半角逗号分隔。必须进行UTF-8编码。}} |
| | | | ||
result= | result= | ||
| 第74行： | 第74行： | ||
}</pre>| | }</pre>| | ||
resultDes=无| | resultDes=无| | ||
| − | useAge=*当只传subid时，返回该订阅的订阅信息，包括订阅的关键词列表、用户列表； | + | useAge=*请使用url: "https://c.api.weibo.com/subscribe/update_subscribe.json 请求该接口。url:https://c.api.weibo.com/2/subscribe/update_subscribe.json 暂不支持； |
| + | *当只传subid时，返回该订阅的订阅信息，包括订阅的关键词列表、用户列表； | ||
*请求该接口的IP必须在此订阅的IP白名单中，否则无法请求该接口； | *请求该接口的IP必须在此订阅的IP白名单中，否则无法请求该接口； | ||
| − | * | + | *英文关键词不区分大小写； |
| + | *该接口不需要登录认证，不需要传入access_token参数，但参数source必传；| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2018年4月12日 (四) 15:07的最后版本
subscribe/update_subscribe
订阅关键词、用户。
URL
https://c.api.weibo.com/2/subscribe/update_subscribe.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
False
关于登录授权，参见 如何登录授权
访问授权限制
请求所有商业接口：
- 50000次/小时/IP；
- 50000次/小时/IP；
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| source | false | string | 采用OAuth授权方式不需要此参数，其他授权方式为必填参数，数值为应用的AppKey。 |
| access_token | false | string | 采用OAuth授权方式为必填参数，其他授权方式不需要此参数，OAuth授权后获得。 |
| subid | true | int | 订阅ID（详情)。 |
| add_keywords | false | string | 添加要订阅的关键词，最多指定50个关键词，由英文半角逗号分隔。必须进行UTF-8编码。 |
| del_keywords | false | string | 删除已订阅的关键词，最多指定50个关键词，由英文半角逗号分隔。必须进行UTF-8编码。 |
| add_uids | false | string | 添加要订阅的用户，最多指定50个用户ID或用户昵称，由英文半角逗号分隔。必须进行UTF-8编码。 |
| del_uids | false | string | 删除已订阅的用户，最多指定50个用户ID或用户昵称，由英文半角逗号分隔。必须进行UTF-8编码。 |
注意事项
- 请使用url: "https://c.api.weibo.com/subscribe/update_subscribe.json 请求该接口。url:https://c.api.weibo.com/2/subscribe/update_subscribe.json 暂不支持；
- 当只传subid时，返回该订阅的订阅信息，包括订阅的关键词列表、用户列表；
- 请求该接口的IP必须在此订阅的IP白名单中，否则无法请求该接口；
- 英文关键词不区分大小写；
- 该接口不需要登录认证，不需要传入access_token参数，但参数source必传；
返回结果
JSON示例
//成功返回
{
"result":true
}
//或
{
"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": "",
}
}
//失败返回
{
"request": "/statuses/bilateral_timeline/ids.json",
"error_code": "201XX",
"error": "error message."
}关于错误返回值与错误代码，参见 错误代码说明
字段说明
无
其他
无
文档更新时间: 2018-04-12
