接口文档

接口文档


帖子列表(首页)

<h5>简要描述</h5> <ul> <li>帖子列表(首页)</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/listThread</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET </li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>类型 关注follow 热门hot 全部all</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>页码</td> </tr> <tr> <td style="text-align: left;">pageSize</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>数量</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ "code": 200, "data": { "data": [ { "thread_id": 6, "title": "ceshi1111", "info": "正在整理书单,有想要加书单的吗?题材不限,读起来轻松愉快不费脑的就好。我会每一本都认真读,然后写推荐语哦。", "category_id": 2, "category_name": "推书专区", "reply_number": 0, "like_number": 0, "coll_number": 0, "image": [ "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad.png", "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad1.png" ], "create_time": "2021-11-30 11:02:43", "update_time": "2021-11-30 11:02:43", "is_coll": false, "is_like": false, "user": { "user_id": 1, "nickname": "999999", "user_exp_level": 3, "user_exp_level_name": "LV3", "avatar": "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/default/user/default_avatar.png", "follow_status": 0 } }, { "thread_id": 7, "title": "ceshi1111", "info": "正在整理书单,有想要加书单的吗?题材不限,读起来轻松愉快不费脑的就好。我会每一本都认真读,然后写推荐语哦。", "category_id": 2, "category_name": "推书专区", "reply_number": 0, "like_number": 0, "coll_number": 0, "image": [ "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad.png", "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad1.png" ], "create_time": "2021-11-30 11:06:32", "update_time": "2021-11-30 11:06:32", "is_coll": false, "is_like": false, "user": { "user_id": 1, "nickname": "999999", "user_exp_level": 3, "user_exp_level_name": "LV3", "avatar": "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/default/user/default_avatar.png", "follow_status": 0 } }, { "thread_id": 8, "title": "hahhahhah1", "info": "55555555555555的吗?题材不限,读起来轻松愉快不费脑的就好。我会每一本都认真读,然后写推荐语哦。", "category_id": 3, "category_name": "求书专区", "reply_number": 0, "like_number": 0, "coll_number": 0, "image": [ "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad.png" ], "create_time": "2021-11-30 11:26:34", "update_time": "2021-11-30 11:26:34", "is_coll": false, "is_like": false, "user": { "user_id": 1, "nickname": "999999", "user_exp_level": 3, "user_exp_level_name": "LV3", "avatar": "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/default/user/default_avatar.png", "follow_status": 0 } } ], "total": 10, "sticky_thread_list": [ { "thread_id": 12, "title": "hahhahhah5" }, { "thread_id": 13, "title": "hahhahhah6" }, { "thread_id": 14, "title": "hahhahhah7" } ], "ad_list": [ { "type": 1, "param": "1", "title": "小说", "image": "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad.png" }, { "type": 1, "param": "2", "title": "小说", "image": "http://oss-tsj.oss-cn-hangzhou.aliyuncs.com/ad/ad1.png" } ] }, "message": "" }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">thread_id</td> <td style="text-align: left;">int</td> <td>帖子id</td> </tr> <tr> <td style="text-align: left;">title</td> <td style="text-align: left;">int</td> <td>标题</td> </tr> <tr> <td style="text-align: left;">info</td> <td style="text-align: left;">int</td> <td>简介</td> </tr> <tr> <td style="text-align: left;">category_id</td> <td style="text-align: left;">int</td> <td>分类id</td> </tr> <tr> <td style="text-align: left;">category_name</td> <td style="text-align: left;">int</td> <td>分类名称(标签)</td> </tr> <tr> <td style="text-align: left;">reply_number</td> <td style="text-align: left;">int</td> <td>评论数量</td> </tr> <tr> <td style="text-align: left;">like_number</td> <td style="text-align: left;">int</td> <td>点赞数量</td> </tr> <tr> <td style="text-align: left;">coll_number</td> <td style="text-align: left;">int</td> <td>收藏数量</td> </tr> <tr> <td style="text-align: left;">image</td> <td style="text-align: left;">array</td> <td>图片</td> </tr> <tr> <td style="text-align: left;">create_time</td> <td style="text-align: left;">int</td> <td>创建时间</td> </tr> <tr> <td style="text-align: left;">update_time</td> <td style="text-align: left;">int</td> <td>更新时间</td> </tr> <tr> <td style="text-align: left;">is_coll</td> <td style="text-align: left;">int</td> <td>是否收藏</td> </tr> <tr> <td style="text-align: left;">is_like</td> <td style="text-align: left;">int</td> <td>是否点赞</td> </tr> <tr> <td style="text-align: left;">is_sticky</td> <td style="text-align: left;">int</td> <td>是否置顶</td> </tr> <tr> <td style="text-align: left;">is_essence</td> <td style="text-align: left;">int</td> <td>是否加精</td> </tr> <tr> <td style="text-align: left;">user</td> <td style="text-align: left;">object</td> <td>用户信息</td> </tr> <tr> <td style="text-align: left;">user.user_id</td> <td style="text-align: left;">int</td> <td>用户id</td> </tr> <tr> <td style="text-align: left;">user.nickname</td> <td style="text-align: left;">string</td> <td>用户昵称</td> </tr> <tr> <td style="text-align: left;">user. avatar</td> <td style="text-align: left;">string</td> <td>用户头像</td> </tr> <tr> <td style="text-align: left;">user.user_exp_level_name</td> <td style="text-align: left;">string</td> <td>用户经验等级名称</td> </tr> <tr> <td style="text-align: left;">user. user_exp_level</td> <td style="text-align: left;">int</td> <td>用户经验等级</td> </tr> <tr> <td style="text-align: left;">user.follow_status</td> <td style="text-align: left;">int</td> <td>用户关注状态 0未关注1已关注2相互关注</td> </tr> <tr> <td style="text-align: left;">sticky_thread_list</td> <td style="text-align: left;">int</td> <td>用户组id,1:超级管理员;2:普通用户</td> </tr> <tr> <td style="text-align: left;">sticky_thread_list.thread_id</td> <td style="text-align: left;">int</td> <td>用户组id,1:超级管理员;2:普通用户</td> </tr> <tr> <td style="text-align: left;">sticky_thread_list.title</td> <td style="text-align: left;">int</td> <td>用户组id,1:超级管理员;2:普通用户</td> </tr> <tr> <td style="text-align: left;">ad_list</td> <td style="text-align: left;">array</td> <td>广告列表 只在第一页输出</td> </tr> <tr> <td style="text-align: left;">ad_list.type</td> <td style="text-align: left;">array</td> <td>广告跳转类类型 只在第一页输出</td> </tr> <tr> <td style="text-align: left;">ad_list.title</td> <td style="text-align: left;">array</td> <td>广告标题 只在第一页输出</td> </tr> <tr> <td style="text-align: left;">ad_list.image</td> <td style="text-align: left;">array</td> <td>广告图片 只在第一页输出</td> </tr> <tr> <td style="text-align: left;">ad_list.param</td> <td style="text-align: left;">array</td> <td>广告跳转参数 只在第一页输出</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML