Trends/weekly

跳转到: 导航, 搜索
第1行: 第1行:
== trends/weekly ==
+
{{api_desc2|
按周返回热门话题。返回某一日期之前某一周的话题。
+
uri=trends/weekly|
 
+
desc=返回最近一周内的热门话题。|
=== URL===
+
format=XML/JSON|
http://api.t.sina.com.cn/trends/weekly.format
+
httpMethod=GET|
+
needAuth=true|
=== 格式===
+
rateLimit=true|
xml, json
+
params={{api_args|base_app|false|int|是否基于当前应用来获取数据。1表示基于当前应用来获取数据。}}|
 
+
getParam=|
=== HTTP请求方式===
+
postParam=|
GET
+
result=
+
===XML示例===
=== 是否需要身份验证===
+
<pre>
false
+
<?xml version="1.0" encoding="UTF-8"?>
 
+
<trends>
=== 请求数限制===
+
<time>2010-08-03 07:20</time>
true
+
<trend>
 
+
<name>记忆犹新</name>
=== 请求参数===
+
<query>记忆犹新</query>
* base_app: 选填参数,是否基于当前应用来获取数据。布尔型,true表示基于当前应用来获取数据。
+
</trend>
* date: 选填参数. 起始日期,返回此日期前的话题数据,不填写则默认为当前最热门20条话题。此参数暂不提供。
+
<trend>
* 示例: http://api.t.sina.com.cn/trends/weekly.xml?hour=1
+
<name>金希澈</name>
* exclude: 选填参数. 从话题列表中排除的话题。此参数暂不提供。
+
<query>金希澈</query>
* 示例: http://api.t.sina.com.cn/trends/weekly.xml?exclude=#天气#北京
+
</trend>
 
+
<trend>
=== 返回结果 ===
+
<name>希澈</name>
XML示例:
+
<query>希澈</query>
<?xml version="1.0" encoding="UTF-8"?>
+
</trend>
<trends>
+
<trend>
<time>2010-08-03 07:20</time>
+
<name>李晟敏</name>
<trend>
+
<query>李晟敏</query>
<name>记忆犹新</name>
+
</trend>
<query>记忆犹新</query>
+
<trend>
</trend>
+
<name>刘惜君</name>
<trend>
+
<query>刘惜君</query>
<name>金希澈</name>
+
</trend>
<query>金希澈</query>
+
<trend>
</trend>
+
<name>陈文茜</name>
<trend>
+
<query>陈文茜</query>
<name>希澈</name>
+
</trend>
<query>希澈</query>
+
<trend>
</trend>
+
<name>理想型</name>
<trend>
+
<query>理想型</query>
<name>李晟敏</name>
+
</trend>
<query>李晟敏</query>
+
<trend>
</trend>
+
<name>晚霞</name>
<trend>
+
<query>晚霞</query>
<name>刘惜君</name>
+
</trend>
<query>刘惜君</query>
+
<trend>
</trend>
+
<name>洗碗</name>
<trend>
+
<query>洗碗</query>
<name>陈文茜</name>
+
</trend>
<query>陈文茜</query>
+
<trend>
</trend>
+
<name>狗叫</name>
<trend>
+
<query>狗叫</query>
<name>理想型</name>
+
</trend>
<query>理想型</query>
+
<as_of>1280833537</as_of>
</trend>
+
</trend>
<trend>
+
</pre>
<name>晚霞</name>
+
===JSON示例===
<query>晚霞</query>
+
<pre>
</trend>
+
{"trends":{
<trend>
+
"2010-08-03 07:20":
<name>洗碗</name>
+
[
<query>洗碗</query>
+
  {
</trend>
+
"name":"记忆犹新",
<trend>
+
"query":"记忆犹新",
<name>狗叫</name>
+
  },
<query>狗叫</query>
+
  {
</trend>
+
"name":"金希澈",
<as_of>1280833537</as_of>
+
"query":"金希澈",
  </trend>
+
  },
 
+
  {
JSON示例:
+
"name":"希澈",
 
+
"query":"希澈",
{"trends":{
+
  },
  "2010-08-03 07:20":
+
  {
[
+
"name":"李晟敏",
  {
+
"query":"李晟敏",
"name":"记忆犹新",
+
  },
"query":"记忆犹新",
+
  {
 +
"name":"刘惜君",
 +
"query":"刘惜君",
 +
  },
 +
  {
 +
"name":"陈文茜",
 +
"query":"陈文茜",
 +
  },
 +
  {
 +
"name":"理想型",
 +
"query":"理想型",
 +
  },
 +
  {
 +
"name":"晚霞",
 +
"query":"晚霞",
 
    },
 
    },
  {
+
  {
"name":"金希澈",
+
"name":"洗碗",
"query":"金希澈",
+
"query":"洗碗",
  },
+
  },
  {
+
  {
"name":"希澈",
+
"name":"狗叫",
"query":"希澈",
+
"query":"狗叫",
  },
+
  }
  {
+
]},
"name":"李晟敏",
+
as_of:1280833537,
"query":"李晟敏",
+
}
  },
+
</pre>|
  {
+
useAge=无|
"name":"刘惜君",
+
otherInfo=
"query":"刘惜君",
+
}}{{#a:showgrade}}
  },
+
  {
+
"name":"陈文茜",
+
"query":"陈文茜",
+
  },
+
  {
+
"name":"理想型",
+
"query":"理想型",
+
  },
+
  {
+
"name":"晚霞",
+
"query":"晚霞",
+
    },
+
  {
+
"name":"洗碗",
+
"query":"洗碗",
+
  },
+
  {
+
"name":"狗叫",
+
  "query":"狗叫",
+
  }
+
]},
+
as_of:1280833537,
+
}
+
 
+
=== 使用示例===
+
 
+
* xml:
+
# curl -u uid:password http://api.t.sina.com.cn/trends/weekly.xml?hour=1
+
# curl -u uid:password http://api.t.sina.com.cn/trends/weekly.xml?exclude=#天气#北京
+
 
+
* json:
+
# curl -u uid:password http://api.t.sina.com.cn/trends/weekly.json?hour=1
+
# curl -u uid:password http://api.t.sina.com.cn/trends/weekly.json?exclude=#天气#北京
+

2010年12月13日 (一) 18:10的版本

目录

trends/weekly

返回最近一周内的热门话题。

URL

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

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

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

请求数限制

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

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
base_app false int 是否基于当前应用来获取数据。1表示基于当前应用来获取数据。

注意事项

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<trends>
	<time>2010-08-03 07:20</time>
	<trend>
		<name>记忆犹新</name>
		<query>记忆犹新</query>
	</trend>
	<trend>
		<name>金希澈</name>
		<query>金希澈</query>
	</trend>
	<trend>
		<name>希澈</name>
		<query>希澈</query>
	</trend>
	<trend>
		<name>李晟敏</name>
		<query>李晟敏</query>
	</trend>
	<trend>
		<name>刘惜君</name>
		<query>刘惜君</query>
	</trend>
	<trend>
		<name>陈文茜</name>
		<query>陈文茜</query>
	</trend>
	<trend>
		<name>理想型</name>
		<query>理想型</query>
	</trend>
	<trend>
		<name>晚霞</name>
		<query>晚霞</query>
	</trend>
	<trend>
		<name>洗碗</name>
		<query>洗碗</query>
	</trend>
	<trend>
		<name>狗叫</name>
		<query>狗叫</query>
	</trend>
	<as_of>1280833537</as_of>
 </trend>

JSON示例

{"trends":{
 	"2010-08-03 07:20":
	[
	  {
		"name":"记忆犹新",
		"query":"记忆犹新",
	  },
	  {
		"name":"金希澈",
		"query":"金希澈",
	  },
	  {
		"name":"希澈",
		"query":"希澈",
	  },
	  {
		"name":"李晟敏",
		"query":"李晟敏",
	  },
	  {
		"name":"刘惜君",
		"query":"刘惜君",
	  },
	  {
		"name":"陈文茜",
		"query":"陈文茜",
	  },
	  {
		"name":"理想型",
		"query":"理想型",
	  },
	  {
		"name":"晚霞",
		"query":"晚霞",
 	  },
	  {
		"name":"洗碗",
	 	"query":"洗碗",
	  },
	  {
		"name":"狗叫",
 		"query":"狗叫",
	  }
	]},
	as_of:1280833537,
}

其他

api评价