Friendships/destroy
目录 |
friendships/destroy
取消关注某用户。成功则返回被取消关注人的资料,失败则返回一条字符串的说明。
URL
http://api.t.sina.com.cn/friendships/destroy/id.format
格式
xml, json
HTTP请求方式
POST, DELETE
是否需要身份验证
true
请求数限制
false
请求参数
下面的参数必须有其中一个:
- id. 必填参数. 要取消关注的用户UID或微博昵称
o 示例: http://api.t.sina.com.cn/friendships/destroy/12345.json or http://api.t.sina.com.cn/friendships/destroy/bob.xml
- user_id. 必填参数. 要取消关注的用户UID,主要是用在区分用户UID跟微博昵称一样,产生歧义的时候。
o 示例: http://api.t.sina.com.cn/friendships/destroy.xml?user_id=1401881
- screen_name. 必填参数. 要取消的微博昵称,主要是用在区分用户UID跟微博昵称一样,产生歧义的时候。
o 示例: http://api.t.sina.com.cn/friendships/destroy.xml?screen_name=101010
返回结果
XML示例:
<?xml version="1.0" encoding="UTF-8"?> <user> <id>11075</id> <screen_name>name_11075</screen_name> <name>name_11075</name> <province>0</province> <city>0</city> <location></location> <description></description> <url></url> <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url> <domain>11075</domain> <gender></gender> <followers_count>28</followers_count> <friends_count>50</friends_count> <statuses_count>29</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at> <following>false</following> <verified>true</verified> <geo_enabled>false</geo_enabled> <status> <created_at>Thu Jan 07 17:36:07 +0800 2010</created_at> <id>142309</id> <text>要查询的微博ID</text> <source> <a id="0" href="http://t.sina.com.cn">Web</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> </status> </user>
JSON示例:
{ "id":11075, "screen_name":"name_11075", "name":"name_11075", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0", "domain":"11075", "followers_count":28, "friends_count":50, "statuses_count":29, "favourites_count":0, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":true, "status": {"created_at":"Thu Jan 07 17:36:07 +0800 2010", "id":142309, "text":"要查询的微博ID", "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null} }
使用示例
- xml:
curl -u user:password -d "" http://api.t.sina.com.cn/friendships/destroy/11075.xml
- json:
curl -u user:password -d "" http://api.t.sina.com.cn/friendships/destroy/11075.json
Java示例
请从 微博SDK开发包下载 下载Java SDK
代码示例如下:
package weibo4j.examples; import weibo4j.Weibo; import weibo4j.WeiboException; public class DestroyFriendship { /** * 取消关注 * @param args */ public static void main(String[] args) { System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY); System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET); try { User user = getWeibo(true,args).destroyFriendship(args[2]);//args[2]:关注用户的id System.out.println(user.toString()); } catch (WeiboException e) { e.printStackTrace(); } } private static Weibo getWeibo(boolean isOauth,String[] args) { Weibo weibo = new Weibo(); if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙 weibo.setToken(args[0], args[1]); }else {//用户登录方式 weibo.setUserId(args[0]);//用户名/ID weibo.setPassword(args[1]);//密码 } return weibo; } }
PHP示例
//friendships/destroy //取消关注 $c = new WeiboClient( WB_AKEY , WB_SKEY , $_SESSION['last_key']['oauth_token'] , $_SESSION['last_key']['oauth_token_secret'] ); //关注用户的id $u_id = "u_id"; $msg = $c->unfollow($u_id); if ($msg === false || $msg === null){ echo "Error occured"; return false; } if (isset($msg['error_code']) && isset($msg['error'])){ echo ('Error_code: '.$msg['error_code'].'; Error: '.$msg['error'] ); return false; } if (isset($msg['screen_name'])){ echo('Unfollow Friend:'.$msg['screen_name']); }