Bbs/getarticlelist

出自天涯开放平台资源

跳转到: 导航, 搜索

目录

bbs/getarticlelist

获取某个版块下的帖子列表

URL

http://open.tianya.cn/api/bbs/getarticlelist.php

支持格式

XML/JSON 

HTTP请求方式

GET/POST

是否需要登录

true

关于授权机制,参见OAuth相关说明

请求数限制

true

关于请求数限制,参见OAuth相关说明

请求参数

  必选 类型及范围 说明
appkey true string 申请应用时分配的appkey,调用接口时候代表应用的唯一身份
oauth_token true string 授权成功后所获得的 oauth_token
oauth_token_secret true string 授权成功后所获得的oauth_token_secret
timestamp true string 请求时候产生的时间戳time()
tempkey true string strtoupper(md5($timestamp.$appkey.$oauth_token.$oauth_token_secret.$appsecret))
item true string 版面ID(从getitemlist从可获取到)
subitem false string 子栏目ID
nexttime true int 分页回复时间[按回复排序](第一页不需要传,从返回数据的reply_time取值)
pagesize true int 每页帖子的大小
outformat true string json或xml

注意事项

	http://open.tianya.cn/api/bbs/getarticlelist.php

若取当前用信息错误,则返回400错误,提示:"error_code"=>"40002", "error_msg"=>"request data error若取当前用信息错误,则返回400错误,提示: "error_code"=>"40002", "error_msg"=>"request data error"

返回结果

XML示例
<?xml version="1.0" encoding="utf8"?><rows><item id="0"><id>1070</id><title>提供一个qq群来交流:78028225</title><grade>蓝脸</grade><author_id>1482545</author_id><author_name>啊鹤在线</author_name><reply_count>1</reply_count><click_count>96</click_count><compose_time>2011-08-10 13:26:42.627</compose_time><reply_time>2011-09-01 22:52:44.38</reply_time></item><item id="1"><id>909</id><title>我也发帖</title><grade>蓝脸</grade><author_id>48629453</author_id><author_name>霸气的白小白</author_name><reply_count>4</reply_count><click_count>238</click_count><compose_time>2011-04-09 09:14:12.093</compose_time><reply_time>2011-09-01 22:51:37.753</reply_time></item></rows>
JSON示例
{"rows":[{"id":"1070","title":"提供一个qq群来交流:78028225","grade":"蓝脸","author_id":"1482545","author_name":"啊鹤在线","reply_count":"1","click_count":"96","compose_time":"2011-08-10 13:26:42.627","reply_time":"2011-09-01 22:52:44.38"},{"id":"909","title":"我也发帖","grade":"蓝脸","author_id":"48629453","author_name":"霸气的白小白","reply_count":"4","click_count":"238","compose_time":"2011-04-09 09:14:12.093","reply_time":"2011-09-01 22:51:37.753"}]}

返回数据示例

名称 类型 输出条件 说明 id int 帖子ID
item String 版块ID
title String 标题
grade String 红脸、绿脸、黑脸、蓝脸
author_id int 作者ID
author_name String 作者名
reply_count int 回复数
click_count int 点击数
compose_time timestamp 发表时间
reply_time timestamp 最新回复时间

PHP示例

SDK下载
代码示例如下: 
include 'tyapi.php'; 
//参数设置 
$appkey=; 
$appsecret=;
$url = 'http://open.tianya.cn/api/bbs/getarticlelist.php';
$param[‘item’]=784;
$param[nexttime’]=’ 2011-09-01 22:51:37.753’;
$param[‘page’]=1;
查看
个人工具
成功案例
帮助中心