论坛 RESTful Api 接口

获取帖子列表

接口地址: https://3yya.com/u/{rel_key}/bbs/app/posts

请求方式: get

请求消息头:

协议头 必填 描述
Authorization 可选 登录时返回的 token。

请求参数:

参数名 类型 必填 说明
page int 默认值:1。返回的页码,从 1 开始。
limit int 默认值:10。返回的帖子数。

返回参数:

参数名 类型 说明
amount int 帖子的总数量。
results list 帖子列表。
title string 帖子标题。
excerpt string 帖子摘要。
post_id int 帖子 id。
publish_time int 发布时间戳。
update_time int 更新时间戳。
author_id int 作者 id。
author_name string 作者用户名。
author_avatar_url string 作者头像地址。
is_thumb bool 是否已点赞。(未登录下为 false)
thumb_amount int 点赞数
visit_amount int 浏览量
discussion_amount int 评论数。
thumbnail_url string 缩略图,如果文章中存在图片则返回第一张图片作为缩略图

JSON 返回示例:

{
    results: [
        {
            post_id: 22,
            title: "大学",
            excerpt: " 大学之道,在明明德,在亲民,在止于至善。知止而后有定,定而后能静,静而后能安,安而后能虑,虑而后能得。物有本末,事有终始,知所先后,则近道矣。 古之欲明明德于天下者,先治其国,欲治其国者,先齐其家;欲齐其家者,先修其身;欲修其身者,先正其心;欲正其心者,先诚其意;欲诚其意者,先致其知,致知在格物。物格而后知至,知至而后意诚,意诚而后心正,心正而后身修,身修而后家齐,家齐而后国治,国治而后天下平。自天子以至于庶人,壹是皆以修身为本。其本乱而末治者,否矣。其所厚者薄,而其所薄者厚,未之有也。此谓知本,此谓知之至也。 所谓诚其意者,毋自欺也。如恶恶臭,如好好色,此之谓自谦。故君子必慎其独也。小人闲居为不善,无所不至,见君子而后厌然,拚其不善,而著其善。人之视己,如见其肝肺然,则何益矣。此谓诚于中形于外。故君子必慎其独也。曾子曰:”富润屋,德润身,心广体胖,故君子必诚其意。 诗云:”如切如",
            publish_time: 1634636394,
            update_time: 1634636394,
            author_id: 3,
            author_name: "西瓜lalavilaxxww",
            author_avatar_url: "https://qiniu.3yya.com/images/37edc98a89b040f8a6b350c06d7a82dc/Snipaste_2022-04-24_22-49-31.jpg",
            is_thumb: false,
            thumb_amount: 32,
            visit_amount: 20,
            discussion_amount: 6,
            thumbnail_url: "https://qiniu.3yya.com/images/37edc98a89b040f8a6b350c06d7a82dc/Snipaste_2022-04-24_22-49-31.jpg"
        },
        {
            post_id: 23,
            title: "前出师表",
            excerpt: " 先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。 宫中府中,俱为一体,陟罚臧否,不宜异同。若有作奸犯科及为忠善者,宜付有司论其刑赏,以昭陛下平明之理,不宜偏私,使内外异法也。 侍中、侍郎郭攸之、费祎、董允等,此皆良实,志虑忠纯,是以先帝简拔以遗陛下。愚以为宫中之事,事无大小,悉以咨之,然后施行,必能裨补阙漏,有所广益。 将军向宠,性行淑均,晓畅军事,试用于昔日,先帝称之曰能,是以众议举宠为督。愚以为营中之事,悉以咨之,必能使行阵和睦,优劣得所。 亲贤臣,远小人,此先汉所以兴隆也;亲小人,远贤臣,此后汉所以倾颓也。先帝在时,每与臣论此事,未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军,此悉贞良死节之臣,愿陛下",
            publish_time: 1634636394,
            update_time: 1634636394,
            author_id: 3,
            author_name: "西瓜lalavilaxxww",
            author_avatar_url: "",
            is_thumb: false,
            discussion_amount: 6,
            thumb_amount: 6,
            visit_amount: 1,
            thumbnail_url: ""
        },
        {
            post_id: 24,
            title: "后出师表",
            excerpt: " 先帝深虑汉、贼不两立,王业不偏安,故托臣以讨贼也。以先帝之明,量臣之才,固知臣伐贼,才弱敌强也。然不伐贼,王业亦亡。惟坐而待亡,孰与伐之?是故托臣而弗疑也。臣受命之日,寝不安席,食不甘味。思惟北征。宜先入南。故五月渡泸,深入不毛,并日而食;臣非不自惜也,顾王业不可得偏安于蜀都,故冒危难,以奉先帝之遗意也,而议者谓为非计。今贼适疲于西,又务于东,兵法乘劳,此进趋之时也。谨陈其事如左: 高帝明并日月,谋臣渊深,然涉险被创,危然后安。今陛下未及高帝,谋臣不如良、平,而欲以长策取胜,坐定天下,此臣之未解一也。 刘繇、王朗各据州郡,论安言计,动引圣人,群疑满腹,众难塞胸,今岁不战,明年不征,使孙策坐大,遂并江东,此臣之未解二也。 曹操智计,殊绝于人,其用兵也,仿佛孙、吴,然困于南阳,险于乌巢,危于祁连,逼于黎阳,几败北山,殆死潼关,然后伪定一时耳。况臣才弱,而欲以不危而定之,此臣之未解三也。",
            publish_time: 1634636395,
            update_time: 1634636395,
            author_id: 3,
            author_name: "西瓜lalavilaxxww",
            author_avatar_url: "",
            is_thumb: false,
            thumb_amount: 0,
            visit_amount: 6,
            discussion_amount: 6,
            thumbnail_url: ""
        },
    ],
    amount: 3,
}