friendships/destroy

UnFollows a user. Returns the befriended user’s profile when successful.

URL

http://api.t.sina.com.cn/friendships/destroy.(json%7Cxml)

Supported Formats

XML/JSON

HTTP Request Method

POST/DELETE

Requires Authentication

true
See the Authorization Mechanism Statement for authorization details

Requests Count Limitation

true
See the Interface Access Rights Statement for the Request Count Limitaiton details.

Request Parameters

Notes

•  :id is a RESTful parameter. URL of using this parameter:
  http://api.t.sina.com.cn/friendships/create/:id.format
  Usage examples:
  http://api.t.sina.com.cn/friendships/create/1658122963.xml?source=appkey
  http://api.t.sina.com.cn/friendships/create/zhangwei217245.json?source=appkey
• Returns 400 error when follows ID does not exist.
• Returns HTTP 403 status when the user has already been friended.

Example Request

XML

curl -u "username:password" -d "user_id=uid" "http://api.t.sina.com.cn/friendships/destroy.xml?source=appkey"

JSON

curl -u "username:password" -d "user_id=uid" "http://api.t.sina.com.cn/friendships/destroy.json?source=appkey"

Response

XML Example

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id>1474388131</id>
  <screen_name>.......</screen_name>
  <name>.......</name>
  <province>11</province>
  <city>8</city>
  <location>北京 海淀区</location>
  <description>.......</description>
  <url>http://1</url>
  <profile_image_url>http://tp4.sinaimg.cn/1474388131/50/1287032732/1</profile_image_url>
  <domain>.......</domain>
  <gender>m</gender>
  <followers_count>40</followers_count>
  <friends_count>97</friends_count>
  <statuses_count>88</statuses_count>
  <favourites_count>0</favourites_count>
  <created_at>Tue Jul 13 00:00:00 +0800 2010</created_at>
  <following>false</following>
  <verified>false</verified>
  <allow_all_act_msg>false</allow_all_act_msg>
  <geo_enabled>true</geo_enabled>
  <status>
    <created_at>Mon Dec 06 10:24:28 +0800 2010</created_at>
    <id>4116374877</id>
    <text>生死簿上记载,我的寿命还有17437天(约48年)  http://sinaurl.cn/hbyVR6</text>
    <source>
      <a href="http://wanyi.sinaapp.com">玩意网</a>
    </source>
    <favorited>false</favorited>
    <truncated>false</truncated>
    <geo/>
    <in_reply_to_status_id/>
    <in_reply_to_user_id/>
    <in_reply_to_screen_name/>
    <thumbnail_pic>http://ww1.sinaimg.cn/thumbnail/57e160a3jw6dc2ondgoytg.gif</thumbnail_pic>
    <bmiddle_pic>http://ww1.sinaimg.cn/bmiddle/57e160a3jw6dc2ondgoytg.gif</bmiddle_pic>
    <original_pic>http://ww1.sinaimg.cn/large/57e160a3jw6dc2ondgoytg.gif</original_pic>
  </status>
</user>

JSON Example

{
    "name" : "........",
    "domain" : ".........",
    "geo_enabled" : true,
    "followers_count" : 40,
    "statuses_count" : 88,
    "favourites_count" : 0,
    "city" : "8",
    "description" : ".......",
    "verified" : false,
    "status" : 
    {
        "created_at" : "Mon Dec 06 10:24:28 +0800 2010",
        "text" : "生死簿上记载,我的寿命还有17437天(约48年)  http://sinaurl.cn/hbyVR6",
        "bmiddle_pic" : "http://ww1.sinaimg.cn/bmiddle/57e160a3jw6dc2ondgoytg.gif",
        "original_pic" : "http://ww1.sinaimg.cn/large/57e160a3jw6dc2ondgoytg.gif",
        "truncated" : false,
        "in_reply_to_status_id" : "",
        "in_reply_to_screen_name" : "",
        "geo" : null,
        "favorited" : false,
        "thumbnail_pic" : "http://ww1.sinaimg.cn/thumbnail/57e160a3jw6dc2ondgoytg.gif",
        "in_reply_to_user_id" : "",
        "id" : 4116374877,
        "source" : "<a href=\"http://wanyi.sinaapp.com\" rel=\"nofollow\">玩意网</a>"
    },
    "id" : 1474388131,
    "gender" : "m",
    "friends_count" : 97,
    "screen_name" : ".......",
    "allow_all_act_msg" : false,
    "following" : false,
    "url" : "http://1",
    "profile_image_url" : "http://tp4.sinaimg.cn/1474388131/50/1287032732/1",
    "created_at" : "Tue Jul 13 00:00:00 +0800 2010",
    "province" : "11",
    "location" : "北京 海淀区"
}

Field Description - user

• id: User ID
• screen_name: User’s nickname displayed on the home page
• name: Friendly displayed name, the same as screen_name
• province: Province code ( see Province and city code table)
• city: City code ( see Province and city code table)
• location：Address
• description: Personal description
• url: Url of the user’s blog
• profile_image_url: Profile image
• domain: The user’s personalized weibo url
• gender: Gender, m—male, f- - female, n-- unknown
• followers_count: Followers count
• friends_count: Following count
• statuses_count: Weibo count
• favourites_count: Favorites count
• created_at: Created time
• following: Whether the current user is following the user that posts the weibo (Not supported yet)
• verified: Whether the user is verified by his real identity, marked with “V”

Field Description - weibo

• created_at: Create time
• id: Weibo ID
• text: Weibo content
• source: Weibo source
• favorited: Whether it is favroited
• truncated: Whether it is truncated
• in_reply_to_status_id: The reply’s ID
• in_reply_to_user_id: UID of the replyer
• in_reply_to_screen_name: Nickname of replyer
• thumbnail_pic: Thumbnail picture
• bmiddle_pic: Medium picture
• original_pic：Original picture
• user: User profile
• retweeted_status: eposted weibo content, the content is the status, This filed is only available for a reposted weibo.

Others

Java Example

Please download Java SDK from . Weibo SDK Development Kit Dowload Site
Sample Code:

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 Example

Please download PHP SDK with OAUTH supported from Weibo SDK Development Kit Dowload Site
. Sample Code:

//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']);
}