Friendships/show
(未显示4个用户的18个中间版本) | |||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=friendships/show| | |
− | + | desc=返回两个用户关注关系的详细情况| | |
− | = | + | format=XML/JSON| |
− | + | httpMethod=GET| | |
− | + | needAuth=true| | |
− | + | rateLimit=true| | |
− | + | params={{api_args_colspan|1=<div style="color:#FFFFFF;background-color:#bbbbbb;font-weight:bold;text-align:left;padding-left:10px">以下参数可不填,如果不填,则默认取当前登录用户</div>}} | |
− | + | {{api_args|source_id|false|int64|源用户UID}} | |
− | = | + | {{api_args|source_screen_name|false|string|源微博昵称}} |
− | GET | + | {{api_args_colspan|1=<div style="color:#FFFFFF;background-color:#bbbbbb;font-weight:bold;text-align:left;padding-left:10px">以下参数必选其一</div>}} |
− | + | {{api_args|target_id|false|int64|要判断的目标用户ID }} | |
− | = | + | {{api_args|target_screen_name|false|string|要判断的目标用户的微博昵称}}| |
− | true | + | getParam=&target_id=456| |
− | + | postParam=| | |
− | = | + | result= |
− | true | + | ===XML示例=== |
− | + | <pre> | |
− | === | + | <?xml version="1.0" encoding="UTF-8"?> |
− | + | ||
− | + | ||
− | : | + | |
− | + | ||
− | : | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<relationship> | <relationship> | ||
<source> | <source> | ||
第54行: | 第34行: | ||
</target> | </target> | ||
</relationship> | </relationship> | ||
− | + | </pre> | |
− | + | ===JSON示例=== | |
− | + | <pre> | |
− | + | { | |
− | + | "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 | ||
+ | } | ||
} | } | ||
+ | </pre>| | ||
+ | useAge= | ||
+ | * 如果用户已登录,此接口将自动使用当前用户ID作为source_id。但是可强制指定source_id来查询关注关系。 | ||
+ | * 如果源用户或目的用户不存在,将返回http的400错误 | ||
+ | * <blocking>表示source_id用户是否对target_id加黑名单,只对source_id是当前用户有效,即只能看到自己的阻止设置(blocking协议暂不支持返回)| | ||
+ | otherInfo= | ||
+ | ===PHP示例=== | ||
+ | 请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK(支持OAuth验证之版本)<br> | ||
+ | 代码示例如下: | ||
+ | <pre> | ||
+ | //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"; | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
+ | }} |
2012年9月24日 (一) 11:40的最后版本
目录 |
friendships/show
返回两个用户关注关系的详细情况
URL
http://api.t.sina.com.cn/friendships/show.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
以下参数可不填,如果不填,则默认取当前登录用户
| |||
source_id | false | int64 | 源用户UID |
source_screen_name | false | string | 源微博昵称 |
以下参数必选其一
| |||
target_id | false | int64 | 要判断的目标用户ID |
target_screen_name | false | string | 要判断的目标用户的微博昵称 |
注意事项
- 如果用户已登录,此接口将自动使用当前用户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"; } } }
文档更新时间: 2012-09-24