获取标签列表接口

API 调用地址

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

说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/tag/list

调用方法

GET

请求参数

字段名 类型 必填 说明
itemId int 文档 ID,读取指定的文档的 Tag 列表。如果不指定,则读取所有的标签
letter string 首字母,指定首字母可以获取指定的标签集合
type string 链接形式,默认 list,可以是 list|page,type=page 的时候,可以获取到 total
page int 获取指定分页数据,只有在 type=page 的时候有效
limit int 显示数量,limit 可以指定显示数量,按多少数量来分页,比如 limit=“10”则只会显示 10 条,limit 在不是分页列表的时候,支持 offset 模式,也就是 ,分隔模式,如想从第 2 条开始,获取 10 条数据,可以设置成 limit=“2,10”。

返回参数

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

data 结果 item 参数

字段名 类型 说明
id int 标签 ID
title string 标签名称
seo_title string 标签 SEO 标题
url_token string 标签 URL 别名
keywords string 标签关键词
description string 标签简介
first_letter string 首字母
link string 链接
created_time int 标签发布时间戳
updated_time int 标签更新时间戳
status int 标签显示状态

请求数据示例

参数
itemId 1

返回数据示例

{
  "code": 0,
  "data": [
    {
      "id": 2,
      "created_time": 1662733318,
      "updated_time": 1662733318,
      "title": "安企CMS",
      "seo_title": "",
      "keywords": "",
      "url_token": "an-qi-cms",
      "description": "",
      "first_letter": "A",
      "status": 1,
      "link": "https://www.anqicms.com/tag/2/"
    },
    {
      "id": 1,
      "created_time": 1662733318,
      "updated_time": 1662733318,
      "title": "AnqiCMS",
      "seo_title": "",
      "keywords": "",
      "url_token": "anqicms",
      "description": "",
      "first_letter": "A",
      "status": 1,
      "link": "https://www.anqicms.com/tag/1/"
    }
  ],
  "msg": "",
  "total": 2
}

错误代码

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