获取分类列表接口

API 调用地址

{域名地址}/api/category/list

说明:{域名地址} 需要替换成你的域名地址,如 /api/category/list

调用方法

GET

请求参数

字段名 类型 必填 说明
moduleId int 模型ID,可以获取指定文档模型的分类列表如 moduleId="1" 获取文章模型的分类列表。
parentId int 上级分类,可以获取指定上级分类下的子分类,parentId="0"的时候,获取顶级分类。放要获取顶级分类的时候,必须指定模型ID moduleId
limit int 显示数量,limit 可以指定显示数量,按多少数量来分页,比如limit="10"则只会显示10条,limit 在不是分页列表的时候,支持offset模式,也就是 ,分隔模式,如想从第2条开始,获取10条数据,可以设置成 limit="2,10"。

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object[] 结果内容

data结果item参数

字段名 类型 说明
id int 分类ID
parent_id int 分类上级ID
title string 分类名称
seo_title string 分类SEO标题
url_token string 分类URL别名
keywords string 分类关键词
description string 分类简介
module_id int 模型ID
content string 分类内容详情
type int 分类属性值,1 分类,3 单页面
sort int 分类排序值
images string[] 分类Banner图
logo string 分类缩略图
thumb string 分类缩略图
created_time int 分类发布时间戳
updated_time int 分类更新时间戳
status int 分类显示状态

请求数据示例

参数
moduleId 1
parentId 0

返回数据示例

{
    "code": 0,
    "data": [
        {
            "id": 1,
            "created_time": 1607308159,
            "updated_time": 1657761249,
            "title": "AnqiCMS使用帮助",
            "seo_title": "",
            "keywords": "",
            "url_token": "help",
            "description": "",
            "content": "<p><br/></p>",
            "module_id": 1,
            "parent_id": 0,
            "type": 1,
            "sort": 1,
            "images": [],
            "logo": "",
            "status": 1,
            "thumb": "/uploads/202012/7/bd36c37ef742c7be.webp",
        },{
            "id": 2,
            "created_time": 1607308159,
            "updated_time": 1657761249,
            "title": "AnqiCMS模板手册",
            "seo_title": "",
            "keywords": "",
            "url_token": "help",
            "description": "",
            "content": "<p><br/></p>",
            "module_id": 1,
            "parent_id": 0,
            "type": 1,
            "sort": 1,
            "images": [],
            "logo": "",
            "status": 1,
            "thumb": "/uploads/202012/7/bd36c37ef742c7be.webp",
        }
    ],
    "msg": ""
}

错误代码

错误码 说明
0 OK
-1 错误,错误原因在msg中指出
1001 未登录
1002 未授权
200 API请求OK