Tags

跳转到: 导航, 搜索
 
(未显示3个用户的6个中间版本)
第1行: 第1行:
==tags==
+
{{api_desc2|
返回指定用户的标签列表
+
uri=tags|
 
+
desc=返回指定用户的标签列表|
===URL===
+
format=XML/JSON|
http://api.t.sina.com.cn/tags.format
+
httpMethod=GET|
+
needAuth=true|
===格式===
+
rateLimit=true|
xml, json, rss, atom
+
params={{api_args|user_id|true|int64|要获取的标签列表所属的用户ID}}
+
{{api_args|count|false|int,默认20,最大200|单页记录数。}}
===HTTP请求方式===
+
{{api_args|page|false|int|页码。}}|
GET
+
getParam=&user_id=1679271303|
+
postParam=|
===是否需要登录:===
+
result=
true
+
===XML示例===
+
<pre>
===请求数限制===
+
<?xml version="1.0" encoding="UTF-8"?>
true
+
<tags>
 
+
  <tag>
===请求参数===
+
    <id>547035</id>
* user_id: 必填参数,查询用户的ID
+
    <value>网络交易</value>
* 示例: http://api.t.sina.com.cn/tags.xml?user_id=142272
+
  </tag>
* count: 可选参数.  每次返回的最大记录数(即页面大小),不大于200,默认为20。
+
  <tag>
* 示例: http://api.t.sina.com.cn/tags.xml?user_id=12345&count=200
+
    <id>51580</id>
* page: 可选参数. 返回结果的页序号。注意:有分页限制。
+
    <value>C2C</value>
* 示例: http://api.t.sina.com.cn/tags.xml?user_id=12345&page=3
+
  </tag>
 
+
  <tag>
=== 使用说明===
+
    <id>11547</id>
* 缺少参数,将返回400错误
+
    <value>外星人</value>
* 用户ID不存在,将返回500错误
+
  </tag>
 
+
  <tag>
===返回结果===
+
    <id>787292</id>
<?xml version="1.0" encoding="UTF-8"?>
+
    <value>智能设备</value>
<tags>
+
  </tag>
<tag>
+
  <tag>
<id>379</id>
+
    <id>1358</id>
<value>新浪</value>
+
    <value>电子商务</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>220</id>
+
    <id>104715</id>
<value>abc</value>
+
    <value>艺术品交易</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>144</id>
+
    <id>2243</id>
<value>摄影</value>
+
    <value>互联网产品</value>
</tag>
+
  </tag>
<tag>
+
</tags>
<id>201007310000010163</id>
+
</pre>
<value>edf</value>
+
===JSON示例===
</tag>
+
<pre>
<tag>
+
[
<id>32</id>
+
    {
<value>大秦帝国</value>
+
        "547035" : "网络交易"
</tag>
+
    },
<tag>
+
    {
<id>35</id>
+
        "51580" : "C2C"
<value>桂林山水</value>
+
    },
</tag>
+
    {
<tag>
+
        "11547" : "外星人"
<id>33</id>
+
    },
<value>江映蓉</value>
+
    {
</tag>
+
        "787292" : "智能设备"
<tag>
+
    },
<id>201007310000010110</id>
+
    {
<value>test</value>
+
        "1358" : "电子商务"
</tag>a
+
    },
<tag>
+
    {
<id>27</id>
+
        "104715" : "艺术品交易"
<value>街头篮球</value>
+
    },
</tag>
+
    {
</tags>
+
        "2243" : "互联网产品"
 
+
    }
Json示例:
+
]
 
+
</pre>|
[{"379":"新浪"},
+
useAge=无|
{"220":"abc"},
+
otherInfo=
{"144":"摄影"},
+
}}
{"201007310000010163":"edf"},
+
{"32":"大秦帝国"},
+
{"35":"桂林山水"},
+
{"33":"江映蓉"},
+
{"201007310000010110":"test"},
+
{"27":"街头篮球"}]
+
 
+
=== 使用示例 ===
+
* xml:
+
* curl -u xxx:xxxx http://api.t.sina.com.cn/tags.xml?source=0000000&user_id=10503&page=1&count=10
+
* json:
+
* curl -u xxx:xxxx http://api.t.sina.com.cn/tags.json?source=0000000&user_id=10503&page=1&count=10
+

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

目录

tags

返回指定用户的标签列表

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
user_id true int64 要获取的标签列表所属的用户ID
count false int,默认20,最大200 单页记录数。
page false int 页码。

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<tags>
  <tag>
    <id>547035</id>
    <value>网络交易</value>
  </tag>
  <tag>
    <id>51580</id>
    <value>C2C</value>
  </tag>
  <tag>
    <id>11547</id>
    <value>外星人</value>
  </tag>
  <tag>
    <id>787292</id>
    <value>智能设备</value>
  </tag>
  <tag>
    <id>1358</id>
    <value>电子商务</value>
  </tag>
  <tag>
    <id>104715</id>
    <value>艺术品交易</value>
  </tag>
  <tag>
    <id>2243</id>
    <value>互联网产品</value>
  </tag>
</tags>

JSON示例

[
    {
        "547035" : "网络交易"
    },
    {
        "51580" : "C2C"
    },
    {
        "11547" : "外星人"
    },
    {
        "787292" : "智能设备"
    },
    {
        "1358" : "电子商务"
    },
    {
        "104715" : "艺术品交易"
    },
    {
        "2243" : "互联网产品"
    }
]

其他

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