文档
测试

获取文章信息列表

GET
http://{{host}}/API/V1/admin/articles

接口描述

管理员:获取文章的描述性信息,包括文章id,点击量,作者,分类,标题,摘要,发布日期,是否隐藏,点击量,可以通过查询参数限制获取数量上限,类别,排列方式

请求参数

参数名
类型
描述
必填
pagesize
number
示例:5,限制获取文章的数据上限
必填
offset
number
偏移量,默认为0
可选
order
string
pubdate: 按发布时间排序;clicks: 点击量排序
可选
reverse
number
是否反序排列,在使用order参数时生效,默认为1,降序排列
可选
category
string
类别名称
可选
author
string
示例:test
可选
title
string
标题
可选

响应参数

application/json
参数名
类型
描述
必填
code
int
示例:1
必填
message
string
示例:成功
必填
result
object
数据字典
必填
total
int
示例:9
必填
article_infos
array
数据列表
必填
id
int
示例:4
必填
title
string
示例:test
必填
author
string
示例:test
必填
category_id
int
示例:1
必填
alias
string
示例:航空航天
必填
pubdate
string
示例:2021-12-13 18:09:40
必填
abstract
string
示例:test
必填
clicks
int
示例:0
必填
is_hidden
int
0 / 1
必填

说明 / 示例

成功响应 ```http GET http://{{host}}/API/V1/articles?pagesize=5&offset=0&order=clicks&reverse=1 ``` ```js { "code": 1, "message": "成功", "result": { "total": 9, "article_infos": [ { "id": 6, "title": "test3", "author": "test", "category_id": 3, "alias": "美食", "pubdate": "2021-12-13 18:11:52", "abstract": "test", "clicks": 110, "is_hidden" :0 }, { "id": 10, "title": "《三体》之外,中国科幻文学找到生存法则了吗", "author": "蒋肖斌 中国青年报", "category_id": 3, "alias": "美食", "pubdate": "2021-12-14 08:22:00", "abstract": "距离刘慈", "clicks": 20 "is_hidden" :0 }, { "id": 5, "title": "test2", "author": "test", "category_id": 2, "alias": "时政", "pubdate": "2021-12-13 18:09:40", "abstract": "test", "clicks": 10 "is_hidden" :0 }, { "id": 7, "title": "test4", "author": "test", "category_id": 4, "alias": "心情", "pubdate": "2021-11-13 18:11:52", "abstract": "test", "clicks": 3 "is_hidden" :0 }, { "id": 4, "title": "test", "author": "test", "category_id": 1, "alias": "航空航天", "pubdate": "2021-12-13 18:09:40", "abstract": "test", "clicks": 0 "is_hidden" :0 } ] } } ``` ```http GET http://{{host}}/API/V1/articles?pagesize=5&offset=0&order=clicks&reverse=1&category=%E7%BE%8E%E9%A3%9F //原参数: category = "美食" ``` ```js { "code": 1, "message": "成功", "result": { "total": 4, "article_infos": [ { "id": 6, "title": "test3", "author": "test", "category_id": 3, "alias": "美食", "pubdate": "2021-12-13 18:11:52", "abstract": "test", "clicks": 110 "is_hidden" :0 }, { "id": 10, "title": "《三体》之外,中国科幻文学找到生存法则了吗", "author": "蒋肖斌 中国青年报", "category_id": 3, "alias": "美食", "pubdate": "2021-12-14 08:22:00", "abstract": "距离刘慈欣开始在《科幻世界》连载《三体》,已经过去了15年;距离《三体》获得雨果奖,也已过去了6年;但最近科幻的大新闻,还是《三体》,它的影视化终于有了新动静。\\n\\n作为《三体》的“骨灰级粉丝”,90后姑娘王诺诺发现,《三体》已成为“三体学”,可以将生活中的一切现象用《三体》来解释:职场有“黑暗森林法则”,商战有“降维打击”……王诺诺毕业于剑桥大学,曾在互联网大厂工作,正在创业中,职业变了,“兼职”一直没变——她是一名科幻作家。\\n\\n读《三体》的孩子长大了,在《三体》之外,中国科幻文学找到自己的生存法则了吗?", "clicks": 20 }, { "id": 8, "title": "从 Egg.js 到 NestJS,爱码客后端选型之路", "author": "ES2049 Studio", "category_id": 3, "alias": "美食", "pubdate": "2021-12-14 14:19:01", "abstract": "爱码客3.0 开始开发到现在已经过去快整整一年了,虽然我投入其中的时间只有短短4个月,但是在最初后端几乎只有我一个人投入的情况下,可以说也是研究了一些东西,蹚了二三次浑水,来来回回改过五六次结构,心里七上八下的时间也不少,当然最后折腾出来的东西肯定到不了九十分。但,这些都不重要了,事了拂衣去,深藏功(辛)与名(酸)。如今回头,只是把当时一些探索的历程简单记录一下,权当给这段经历画下一个省略号。。。", "clicks": 0 }, { "id": 9, "title": "当 Egg 遇到 TypeScript,收获茶叶蛋一枚", "author": "天猪", "category_id": 3, "alias": "美食", "pubdate": "2021-11-13 18:11:52", "abstract": "本文主要阐述:\\n\\n应用层\\nTS\\n开发规范\\n我们在工具链方面的支持,是如何来解决上述问题,让开发者几乎无感知并保持一致性的开发体验。", "clicks": 0 } ] } } ```