Tags/suggestions

跳转到: 导航, 搜索
 
(未显示1个用户的3个中间版本)
第1行: 第1行:
==tags/suggestions==
+
{{api_desc2|
返回用户感兴趣的标签
+
uri=tags/suggestions|
 
+
desc=获取当前登录用户感兴趣的推荐标签列表|
===URL===
+
format=XML/JSON|
http://api.t.sina.com.cn/tags/suggestions
+
httpMethod=GET|
+
needAuth=true|
===格式===
+
rateLimit=true|
xml, json
+
params={{api_args|count|false|int,默认10,最大10。|单页记录数。}}
+
{{api_args|page|false|int,默认1|页码。由于推荐标签是随机返回,故此特性暂不支持。}}|
===HTTP请求方式===
+
getParam=&count=5|
GET
+
postParam=|
+
result=
===是否需要登录:===
+
===XML示例===
true
+
<pre>
+
<?xml version="1.0" encoding="UTF-8"?>
===请求数限制===
+
<tags>
true
+
  <tag>
 
+
    <id>1033</id>
===请求参数===
+
    <value>上网</value>
* page: 可选参数,页码,默认为1
+
  </tag>
* count: 可选参数,分页大小,默认为10
+
  <tag>
* 示例:http://api.t.sina.com.cn/tags/suggestions.xml?source=0000000&page=1&count=10
+
    <id>5395</id>
 
+
    <value>紫色</value>
===返回结果===
+
  </tag>
Xml示例:
+
  <tag>
 
+
    <id>544</id>
<?xml version="1.0" encoding="UTF-8"?>
+
    <value>历史</value>
<tags>
+
  </tag>
<tag>
+
  <tag>
<id>49</id>
+
    <id>545</id>
<value>四世同堂</value>
+
    <value>广告</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>716</id>
+
    <id>788</id>
<value>动漫</value>
+
    <value>美剧</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>146</id>
+
    <id>660</id>
<value>呼叫中心</value>
+
    <value>八卦</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>112</id>
+
    <id>537</id>
<value>11111111</value>
+
    <value>传媒</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>201007210000010001</id>
+
    <id>331</id>
<value>测试1</value>
+
    <value>网络</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>184</id>
+
    <id>998</id>
<value>阅读</value>
+
    <value>狮子座</value>
</tag>
+
  </tag>
<tag>
+
  <tag>
<id>838</id>
+
    <id>922</id>
<value>美食</value>
+
    <value>游戏</value>
</tag>
+
  </tag>
<tag>
+
</tags>
<id>105</id>
+
</pre>
<value>44</value>
+
===JSON示例===
</tag>
+
<pre>
<tag>
+
[
<id>71</id>
+
    {
<value>mmmmmmmm</value>
+
        "id" : "1698",
</tag>
+
        "value" : "教育"
<tag>
+
    },
<id>54</id>
+
    {
<value>123333</value>
+
        "id" : "1397",
</tag>
+
        "value" : "大学生"
</tags>
+
    },
 
+
    {
Json示例:
+
        "id" : "77463",
[{"719":"氣氛紅橙黃綠藍"},
+
        "value" : "偶喜欢玩"
{"840":"世博志愿者"},
+
    },
{"112":"11111111"},
+
    {
{"201007210000010001":"测试1"},
+
        "id" : "123",
{"185":"皇马"},
+
        "value" : "平常心"
{"108":"77"},
+
    },
{"853":"80"},
+
    {
{"838":"美食"},
+
        "id" : "1029",
{"52":"1233"},
+
        "value" : "宅"
{"118":"三枪"}]
+
    },
 
+
    {
=== 使用示例 ===
+
        "id" : "859",
* xml:
+
        "value" : "博客"
* curl -u xxx:xxxx http://api.t.sina.com.cn/tags/suggestions.xml?source=0000000&page=1&count=10
+
    },
* json:
+
    {
* curl -u xxx:xxxx http://api.t.sina.com.cn/tags/suggestions.json?source=0000000&page=1&count=10
+
        "id" : "320",
 +
        "value" : "搞笑"
 +
    },
 +
    {
 +
        "id" : "283",
 +
        "value" : "电影"
 +
    },
 +
    {
 +
        "id" : "3374",
 +
        "value" : "善良"
 +
    },
 +
    {
 +
        "id" : "835",
 +
        "value" : "读书"
 +
    }
 +
]
 +
</pre>|
 +
useAge=无|
 +
otherInfo=
 +
}}

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

目录

tags/suggestions

获取当前登录用户感兴趣的推荐标签列表

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
count false int,默认10,最大10。 单页记录数。
page false int,默认1 页码。由于推荐标签是随机返回,故此特性暂不支持。

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<tags>
  <tag>
    <id>1033</id>
    <value>上网</value>
  </tag>
  <tag>
    <id>5395</id>
    <value>紫色</value>
  </tag>
  <tag>
    <id>544</id>
    <value>历史</value>
  </tag>
  <tag>
    <id>545</id>
    <value>广告</value>
  </tag>
  <tag>
    <id>788</id>
    <value>美剧</value>
  </tag>
  <tag>
    <id>660</id>
    <value>八卦</value>
  </tag>
  <tag>
    <id>537</id>
    <value>传媒</value>
  </tag>
  <tag>
    <id>331</id>
    <value>网络</value>
  </tag>
  <tag>
    <id>998</id>
    <value>狮子座</value>
  </tag>
  <tag>
    <id>922</id>
    <value>游戏</value>
  </tag>
</tags>

JSON示例

[
    {
        "id" : "1698",
        "value" : "教育"
    },
    {
        "id" : "1397",
        "value" : "大学生"
    },
    {
        "id" : "77463",
        "value" : "偶喜欢玩"
    },
    {
        "id" : "123",
        "value" : "平常心"
    },
    {
        "id" : "1029",
        "value" : "宅"
    },
    {
        "id" : "859",
        "value" : "博客"
    },
    {
        "id" : "320",
        "value" : "搞笑"
    },
    {
        "id" : "283",
        "value" : "电影"
    },
    {
        "id" : "3374",
        "value" : "善良"
    },
    {
        "id" : "835",
        "value" : "读书"
    }
]

其他

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