获取标签详情接口

    获取指定标签的详细信息,包括标签名称、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