Friendships/show
第35行: | 第35行: | ||
* <blocking>表示source_id用户是否对target_id加黑名单,只对source_id是当前用户有效,即只能看到自己的阻止设置(blocking协议暂不支持返回) | * <blocking>表示source_id用户是否对target_id加黑名单,只对source_id是当前用户有效,即只能看到自己的阻止设置(blocking协议暂不支持返回) | ||
− | === | + | ===返回结果=== |
− | + | XML示例: | |
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
<relationship> | <relationship> | ||
第55行: | 第55行: | ||
</relationship> | </relationship> | ||
− | + | JSON示例: | |
{ | { | ||
"relationship": | "relationship": | ||
第75行: | 第75行: | ||
===使用示例=== | ===使用示例=== | ||
− | * | + | * xml: |
curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456 | curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456 | ||
− | * | + | * json: |
curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456 | curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456 |
2010年1月11日 (一) 11:39的版本
目录 |
friendships/show
返回两个用户关系的详细情况
URL
http://api.t.sina.com.cn/friendships/show.format
格式
xml, json
HTTP请求方式
GET
是否需要身份验证
true
请求数限制
true
请求参数
以下参数可不填写,如不填,则取当前用户
- source_id. 源用户UID
- source_screen_name. 源用户昵称
下面参数必须选填一个:
- target_id. 要判断的目的用户UID
- target_screen_name. 要判断的目的用户昵称
使用说明
- 如果用户已登录,此接口将自动使用当前用户ID作为source_id。但是可强制指定source_id来查询关系
- 如果源用户或目的用户不存在,将返回http的404错误
- <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示例:
{ "relationship": {"source":{"id":123, "screen_name":"bob", "following":false, "followed_by":false, "notifications_enabled":false} }, "target": {"id":456, "screen_name":"jack", "following":false, "followed_by":false, "notifications_enabled":false} } }
使用示例
- xml:
curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456
- json:
curl -u user:password http://api.t.sina.com.cn/friendships/show.xml?target_id=456