获取标签详情接口

获取指定标签的详细信息,包括标签名称、SEO信息、链接地址等基本信息。

注意事项

  • 该接口采用GET方法
  • 需要提供标签ID或标签URL别名(filename)来指定查询的标签
  • 标签ID和URL别名二选一,如果提供了filename参数,则可以不传ID
  • 返回标签的基本信息和SEO相关信息
  • 可用于页面标题、关键词和描述的设置

请求地址

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

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

请求语法

GET {域名地址}/api/tag/detail

请求头

此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求参数

字段名 类型 必填 说明
id int 标签ID,如果传了filename,可以不用传ID
filename string 标签URL别名,标签ID、filename二选一

响应头

此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object 标签详情数据

data 参数

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

使用示例

请求示例

GET /api/tag/detail?id=1 HTTP/1.1
Host: www.anqicms.com

响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "id": 1,
    "title": "AnqiCMS",
    "seo_title": "",
    "url_token": "anqicms",
    "keywords": "",
    "description": "",
    "first_letter": "A",
    "link": "https://www.anqicms.com/tag/1/",
     "content": "<p>AnqiCMS 是一个基于 PHP 的开源内容管理系统,支持内容管理、内容发布、内容搜索、内容评论、内容标签、内容分类</p>"
    "created_time": 1662733318,
    "updated_time": 1662733318,
    "status": 1
  }
}

错误代码

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