Trends

跳转到: 导航, 搜索
 
(未显示2个用户的32个中间版本)
第1行: 第1行:
{{api_desc|trends|获取某用户的话题。|XML/JSON|GET|TRUE|TRUE}}
+
{{api_desc2|
 
+
uri=trends|
=== 请求参数===
+
desc=获取某用户的话题。|
*user_id: 必选参数,要获取用户的uid。
+
format=XML/JSON|
* page: 选填参数.页码。缺省为1。
+
httpMethod=GET|
* 示例: http://api.t.sina.com.cn/trends.xml?user_id=12345&page=1
+
needAuth=true|
* count: 选填参数.单页显示数。缺省为10
+
rateLimit=true|
* 示例: http://api.t.sina.com.cn/trends.xml?count=10
+
params={{api_args|user_id|true|int64|用户id}}
 
+
{{api_args|page|false|int,缺省值为1|页码}}
=== 返回结果 ===
+
{{api_args|count|false|int,缺省值为10|每页返回的记录数}}|
XML示例:
+
postParam=|
<?xml version="1.0" encoding="UTF-8"?>
+
getParam=&user_id=12345678&page=1&count=10|
<trends>
+
result=
<trend>
+
===XML示例===
<trend_id>null</trend_id>
+
<pre>
<hotword>ddddsss</hotword>
+
<?xml version="1.0" encoding="UTF-8"?>
<num>1</num>
+
<trends>
</trend>
+
  <trend>
<trend>
+
    <trend_id>1567898</trend_id>
<trend_id>null</trend_id>
+
    <hotword>ipad</hotword>
<hotword>dddd</hotword>
+
    <num>225673</num>
<num>14881</num>
+
  </trend>
</trend>
+
  <trend>
</trends>
+
    <trend_id>1567733</trend_id>
 
+
    <hotword>NBA</hotword>
JSON示例:
+
    <num>106248</num>
 
+
  </trend>
  [{"num":"1","trend_id":"876637","hotword":"ddddsss"},{"num":"14881","trend_id":"876636","hotword":"dddd"}]
+
</trends>
 
+
</pre>
=== 使用示例===
+
===JSON示例===
 
+
<pre>
* xml:
+
[
curl -u uid:password  http://api.t.sina.com.cn/trends.xml -d "source=appkey&user_id=12345678&page=1&count=10"
+
    {
 
+
        "num" : "225673",
* json:
+
        "hotword" : "ipad",
curl -u uid:password http://api.t.sina.com.cn/trends.json -d "source=appkey&user_id=12345678&page=1&count=10"
+
        "trend_id" : "1567898"
 +
    },
 +
    {
 +
        "num" : "106384",
 +
        "hotword" : "NBA",
 +
        "trend_id" : "1567733"
 +
    }
 +
]
 +
</pre>|
 +
useAge=无|
 +
otherInfo=
 +
}}

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

目录

trends

获取某用户的话题。

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
user_id true int64 用户id
page false int,缺省值为1 页码
count false int,缺省值为10 每页返回的记录数

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<trends>
  <trend>
    <trend_id>1567898</trend_id>
    <hotword>ipad</hotword>
    <num>225673</num>
  </trend>
  <trend>
    <trend_id>1567733</trend_id>
    <hotword>NBA</hotword>
    <num>106248</num>
  </trend>
</trends>

JSON示例

[
    {
        "num" : "225673",
        "hotword" : "ipad",
        "trend_id" : "1567898"
    },
    {
        "num" : "106384",
        "hotword" : "NBA",
        "trend_id" : "1567733"
    }
]

其他

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