friendships/show

返回两个用户关注关系的详细情况

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

true
关于授权机制，参见授权机制声明

请求数限制

true
关于请求数限制，参见接口访问权限说明

请求参数

注意事项

• 如果用户已登录，此接口将自动使用当前用户ID作为source_id。但是可强制指定source_id来查询关注关系。
• 如果源用户或目的用户不存在，将返回http的400错误
• <blocking>表示source_id用户是否对target_id加黑名单，只对source_id是当前用户有效，即只能看到自己的阻止设置(blocking协议暂不支持返回)

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
 <relationship>
 <source>
 <id>123</id>
 <screen_name>bob</screen_name>
 <following>true</following>
 <followed_by>false</followed_by>
 <notifications_enabled>false</notifications_enabled>
 </source>
 <target>
 <id>456</id>
 <screen_name>jack</screen_name>
 <following>false</following>
 <followed_by>true</followed_by>
 <notifications_enabled></notifications_enabled>
 </target>
 </relationship>

JSON示例

  {
     "source":{
         "id":245110499
         ,"screen_name":"245110499"
         ,"following":false
         ,"followed_by":false
         ,"notifications_enabled":false
    }
    ,"target":{
         "id":10503      
         ,"screen_name":"10503"
         ,"following":false
         ,"followed_by":false
         ,"notifications_enabled":false
   }
 }

其他

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK（支持OAuth验证之版本）
代码示例如下:

//Friendships/show
$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->is_followed($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['target'])){
	if (isset($msg['target']['followed_by'])){
		if ($msg['target']['followed_by'] === true){
			echo "Target is followed: true";
		} else {
			echo "Target is followed: false";
		}
	}
}