文档列表

1 功能说明

获取指定分类下所有文档列表

2 接口调用说明

2.1 URL
http://yourdomain.kf5.com/api/v1/forum/post_list
2.2 格式

JSON

2.3 HTTP请求方式

GET, POST

2.4 IP限制

2.5 输入参数说明
参数名称是否必须类型描述
forum_idinteger文档分类ID编号
currentpageinteger当前显示的数据页数,默认为1,表示第一页
pagesizeinteger每页显示的记录条数,默认为20条
2.6 请求示例
http://yourdomain.kf5.com/api/v1/forum/post_list?forum_id=418&sign=12d45c66523dd069d7c64c22fea10f34
2.7 返回参数说明
参数名称说明
err返回码。0:执行成功,1:有错误
msg如果错误,返回错误信息。
count数据记录的总条数
currentpage当前显示的数据页数
pagesize每页显示的记录条数
datas返回数据
id文档编号
forum_id所属分类编号
title文档标题
content文档描述
user_id作者编号
disable_comments回复是否关闭
is_top是否置顶显示
is_dashboard是否在控制台首页显示
created创建时间
updated最后修改时间
count_view浏览量
count_comment评论总数
2.8 正确返回示例
Content-type: text/html; charset=utf-8
{
	"err":0,
	"msg":"",
	"count":"47",
	"currentpage":"1",
	"pagesize":"20",
	"datas":{
		"0" : {
			"id" : "165"
			"forum_id" : "418"
			"title" : "test"
			"content" : "testtest"
			"user_id" : "733"
			"disable_comments" : "0"
			"is_top" : "1"
			"is_dashboard" : "0"
			"created" : "1351064099"
			"updated" : "1351064099"
			"count_view" : "28"
			"count_comment" : "4"
		}
		...
	}
}
2.9 错误返回示例
Content-type: text/html; charset=utf-8
{
	"err":1,
	"msg":"参数不完整"
}

3 备注