Trends

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

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