C/2/subscribe/update subscribe
第2行: | 第2行: | ||
uri=subscribe/update_subscribe| | uri=subscribe/update_subscribe| | ||
desc=订阅关键词、用户。| | desc=订阅关键词、用户。| | ||
− | httpMethod= | + | httpMethod=GET| |
needAuth=False| | needAuth=False| | ||
rateLimit={{B_rate_limit}}| | rateLimit={{B_rate_limit}}| |
2013年11月5日 (二) 19:32的版本
subscribe/update_subscribe
订阅关键词、用户。
URL
https://c.api.weibo.com/2/subscribe/update_subscribe.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
False
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
subid | true | int | 订阅ID(详情)。 |
add_keywords | false | string | 添加要订阅的关键词,最多指定20个关键词,由英文半角逗号分隔。 |
del_keywords | false | string | 删除已订阅的关键词,最多指定20个关键词,由英文半角逗号分隔。 |
add_uids | false | string | 添加要订阅的用户ID,最多指定50个用户ID,由英文半角逗号分隔。 |
del_uids | false | string | 删除已订阅的用户ID,最多指定50个用户ID,由英文半角逗号分隔。 |
注意事项
- 请使用url: "http://c.api.weibo.com/subscribe/update_subscribe.json 请求该接口。url:http://c.api.weibo.com/2/subscribe/update_subscribe.json 暂不支持;
- 当只传subid时,返回该订阅的订阅信息,包括订阅的关键词列表、用户列表;
- 请求该接口的IP必须在此订阅的IP白名单中,否则无法请求该接口;
- 该接口不需要登录认证,不需要传入source、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." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无