MyCms 文章列表接口 - API接口说明文档

作者: MyCms
专栏: API接口说明文档

简介

文章列表接口

接口地址

/api/v1/articles

请求参数

名称	必须	描述
tag	否	类型（默认为new） new:最新 hot:最热 category:分类最新 category_hot:分类最热 tag:标签最新 search:搜索 attr:辅助属性
params	否	附带参数当 tag 不为 new和hot时，必须传入才能得到相应结果 category 和 category_hot 传入 {"category_id":分类id} tag 传入 {"tag_id":标签id} search 传入 {"search":关键词} attr 传入 {"name":属性标识}
page	否	页码默认为1
limit	否	每页显示数量默认为10
timestamp	是	当前时间戳
sign	是	签名结果，签名算法介绍请点击这里

返回结果

名称	描述
total	总数
last_page	最后页码
current_page	当前页面
per_page	每页显示数量
article	文章信息
\|--id	文章ID
\|--title	文章标题
\|--category_id	文章分类ID
\|--description	文章描述
\|--img	文章封面图
\|--author	文章作者
\|--view	文章浏览量
\|--created_at	文章创建时间
\|--updated_at	文章更新时间
\|--category	文章分类信息
\|--tags	文章标签集合

返回示例

{
    "result": {
        "total": 9,
        "last_page": 9,
        "current_page": 1,
        "per_page": 1,
        "data": [
            {
                "id": 119,
                "title": "广州美食攻略，让人无法抗拒的广州十大美食",
                "category_id": 6,
                "description": "如果你和小编一样，是个吃货，那么你就一定要对广州这座城市有所了解了，在吃货的眼里啊，广州就是一个人间天堂。俗话说“食在广州，穿在苏州，玩在杭州，死在柳州”。广州的饮食文化源远流长，广州菜也是粤菜的代表，粤菜精致美味、选材广泛。广州讲究“边逛",
                "img": "/grab/img/20211107/21/503d269759ee3d6d794749f14e166d224f4ade03.jpg",
                "author": "探索美食狂人",
                "view": 0,
                "created_at": "2021-11-07 21:15:51",
                "updated_at": "2021-11-07 21:15:51",
                "category": {
                    "id": 6,
                    "name": "最近更新"
                },
                "tags": [
                    {
                        "id": 80,
                        "tag_name": "广州"
                    },
                    {
                        "id": 81,
                        "tag_name": "广州美食"
                    },
                    {
                        "id": 82,
                        "tag_name": "广州美食攻略"
                    },
                    {
                        "id": 83,
                        "tag_name": "美食"
                    },
                    {
                        "id": 84,
                        "tag_name": "美食攻略"
                    },
                    {
                        "id": 85,
                        "tag_name": "攻略"
                    },
                    {
                        "id": 86,
                        "tag_name": "无法"
                    },
                    {
                        "id": 87,
                        "tag_name": "无法抗拒"
                    },
                    {
                        "id": 88,
                        "tag_name": "十大"
                    }
                ]
            }
        ]
    },
    "msg": "返回成功",
    "code": 200
}