标签接口

标签管理相关的 API 接口文档。

获取标签列表

接口信息

GET /api/tags
Authorization: Bearer {token}

请求参数

参数	类型	必填	说明
page	integer	否	页码，默认1
page_size	integer	否	每页数量，默认20
keyword	string	否	关键词搜索
order	string	否	排序字段

响应示例

{
  "code": 200,
  "message": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "name": "Vue.js",
        "alias": "vuejs",
        "color": "#42b983",
        "icon": "fa fa-vuejs",
        "description": "Vue.js 相关文章",
        "article_count": 25,
        "create_time": "2024-01-01 00:00:00"
      }
    ],
    "total": 50,
    "page": 1,
    "page_size": 20
  }
}

获取标签详情

接口信息

GET /api/tags/{id}
Authorization: Bearer {token}

响应示例

{
  "code": 200,
  "data": {
    "id": 1,
    "name": "Vue.js",
    "alias": "vuejs",
    "color": "#42b983",
    "icon": "fa fa-vuejs",
    "description": "Vue.js 相关文章",
    "article_count": 25,
    "create_time": "2024-01-01 00:00:00"
  }
}

创建标签

接口信息

POST /api/tags
Authorization: Bearer {token}
Content-Type: application/json

请求参数

参数	类型	必填	说明
name	string	是	标签名称
alias	string	否	别名，留空自动生成
color	string	否	颜色
icon	string	否	图标
description	string	否	描述

请求示例

{
  "name": "React",
  "alias": "react",
  "color": "#61dafb",
  "description": "React 框架相关"
}

响应示例

{
  "code": 201,
  "message": "创建成功",
  "data": {
    "id": 10,
    "name": "React",
    "alias": "react"
  }
}

更新标签

接口信息

PUT /api/tags/{id}
Authorization: Bearer {token}
Content-Type: application/json

请求参数

与创建标签相同，所有字段可选。

响应示例

{
  "code": 200,
  "message": "更新成功"
}

删除标签

接口信息

DELETE /api/tags/{id}
Authorization: Bearer {token}

响应示例

{
  "code": 200,
  "message": "删除成功"
}

批量操作

批量删除

DELETE /api/tags/batch
Authorization: Bearer {token}
Content-Type: application/json

请求示例

{
  "ids": [1, 2, 3]
}

获取标签文章

接口信息

GET /api/tags/{id}/articles
Authorization: Bearer {token}

请求参数

参数	类型	必填	说明
page	integer	否	页码
page_size	integer	否	每页数量

响应示例

{
  "code": 200,
  "data": {
    "list": [
      {
        "id": 1,
        "title": "Vue 3 新特性",
        "summary": "Vue 3 带来的新特性介绍",
        "create_time": "2024-01-15 10:00:00"
      }
    ],
    "total": 25,
    "page": 1,
    "page_size": 20
  }
}