Blocks/exists

跳转到: 导航, 搜索
(使用示例:)
 
(未显示1个用户的1个中间版本)
第1行: 第1行:
== blocks/exists ==
+
{{api_desc2|
检测是否是黑名单用户
+
uri=blocks/exists|
 
+
desc=检测指定用户是否在登录用户的黑名单内。|
=== URL: ===
+
format=XML/JSON|
http://api.t.sina.com.cn/blocks/exists.format
+
httpMethod=GET|
+
needAuth=true|
===格式:===
+
rateLimit=true|
xml, json
+
params={{api_args|user_id|true|int64|要检测的用户ID}}
+
{{api_args|screen_name|false|string|要检测的用户微博昵称}}|
=== 请求方式: ===
+
getParam=&user_id=12345|
GET
+
postParam=|
+
result=
===是否需要身份验证:===
+
===XML示例===
true
+
<pre>
 
+
<?xml version="1.0" encoding="UTF-8"?>
===请求数限制:===
+
<result>false</result>
true
+
</pre>
 
+
===JSON示例===
===请求参数:===
+
<pre>
必选参数(至少选一个)
+
{
* user_id. 要检查的用户ID
+
     "result" : false
o Example: http://api.t.sina.com.cn/blocks/exists.xml?user_id=1401881
+
}
* screen_name. 要检查的用户昵称
+
</pre>|
o Example: http://api.t.sina.com.cn/blocks/exists.xml?screen_name=101010
+
useAge=
 
+
如果user_id或者screen_name均未提供,则返回400错误。|
===返回结果: ===
+
otherInfo=
XML :
+
}}
  <result>false</result>
+
 
+
JSON example:
+
{
+
     "result": false
+
}
+
 
+
 
+
===使用示例: ===
+
json:
+
 
+
*curl -u uid:password  http://api.t.sina.com.cn/blocks/exists.json -d "source=appkey&user_id=1234567"
+
 
+
xml:
+
 
+
*curl -u uid:password  http://api.t.sina.com.cn/blocks/exists.xml -d "source=appkey&user_id=1234567"
+

2012年9月24日 (一) 11:44的最后版本

目录

blocks/exists

检测指定用户是否在登录用户的黑名单内。

URL

http://api.t.sina.com.cn/blocks/exists.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
user_id true int64 要检测的用户ID
screen_name false string 要检测的用户微博昵称

注意事项

如果user_id或者screen_name均未提供,则返回400错误。

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<result>false</result>

JSON示例

{
    "result" : false
}

其他

文档更新时间: 2012-09-24