在安企CMS中，标签（Tags）是组织内容、提升用户体验和优化搜索引擎排名的重要工具。它们能够帮助访客快速找到相关内容，也能让网站管理员更好地管理信息。当我们浏览某个文档详情页时，常常希望能看到与该文档相关联的所有标签列表，这不仅能引导用户发现更多相关内容，也能丰富页面的语义结构。
要获取与特定文档关联的标签列表，我们通常需要分两步来操作：首先是确定目标文档的唯一标识，然后利用这个标识去请求其关联的标签数据。
第一步：获取文档的唯一标识（ID）
在安企CMS中，每个文档都有一个唯一的ID。这是我们后续获取标签的关键。您可以通过archive/detail接口来获取单个文档的详细信息，其中就包含了这个ID。
这个接口的调用方法是GET。您可以通过两种方式指定要查询的文档：
- 使用文档ID： 如果您已经知道文档的数字ID，可以直接作为
id参数传递。 - 使用文档URL别名： 如果您知道文档的URL别名（
filename），也可以用它来查询。
举例来说，如果您知道某个文档的ID是1，您可以向{域名地址}/api/archive/detail?id=1发送GET请求。
接口成功返回后，您会在返回的数据的data字段中找到一个名为id的整数值，这就是该文档的唯一ID。同时，您也会看到该文档的keywords字段，这通常是文档的关键词集合，但它并非我们正在寻找的结构化标签列表。
第二步：利用文档ID获取关联标签列表
有了文档的唯一ID，获取与之关联的标签就变得非常直接了。安企CMS提供了一个专门的tag/list接口，它可以根据文档ID来列出所有关联的标签。
您同样需要使用GET方法来调用这个接口。其中最关键的参数就是itemId，您需要将第一步获取到的文档ID赋值给这个参数。
例如，如果您在第一步中获取到的文档ID是1，那么您可以向{域名地址}/api/tag/list?itemId=1发送GET请求。
接口会返回一个包含标签对象的data数组。数组中的每一个对象都代表一个标签，通常会包含以下重要信息：
id: 标签的唯一ID。title: 标签的名称，也就是我们通常看到的标签文字。url_token: 标签的URL别名，可以用于构建标签的专属链接。link: 标签的详情页链接，点击后可以查看所有包含该标签的文档。
通过遍历这个data数组，您就可以获取到与当前文档关联的所有标签，并可以根据需要，将它们展示在页面的任何位置，例如在文章内容的下方，或者在侧边栏中。
总结工作流程
整个获取文档关联标签的过程可以概括为：
- 通过
GET {域名地址}/api/archive/detail?id={文档ID}（或使用filename）获取当前文档的详细信息，从中提取出文档的id。 - 然后，使用这个
id作为itemId参数，调用GET {域名地址}/api/tag/list?itemId={文档ID}，即可得到该文档关联的所有标签的详细列表。
这样的两步操作，不仅清晰地分离了文档信息和标签信息，也为开发者提供了灵活的数据获取方式。在前端展示时，您可以利用title作为标签文本，link作为标签的超链接，从而构建出富有交互性的标签云或相关内容导航区域，极大地提升用户的浏览体验。
常见问题 (FAQ)
Q1: 如果文档没有设置任何标签，tag/list接口会返回什么？
A: 如果文档没有关联任何标签，tag/list接口的data字段会返回一个空数组。这意味着您在处理接口响应时，需要检查data数组是否为空，如果为空，则可以选择不显示标签区域，或者显示“暂无标签”等提示信息。
Q2: archive/detail接口返回的keywords字段和tag/list接口获取的tags有什么区别？
A: archive/detail接口中的keywords字段通常是文档的关键词，它们是纯文本，例如“安企CMS,CMS系统,建站教程”，主要用于SEO目的，告诉搜索引擎文档的主题。而通过tag/list接口获取的tags是一个结构化的标签对象数组，每个标签都有自己的ID、标题和独立的链接。在安企CMS中，这些标签被视为独立的内容实体，更适合用于构建可点击的标签云或相关内容导航，它们具有更强的交互性和内容聚合能力。
Q3: 是否可以在不先获取文档详情的情况下直接获取某个文档的标签？
A: 不能直接在不知道文档ID的情况下获取特定文档的标签列表。tag/list接口的itemId参数是必需的，它明确指出了要查询哪个文档的标签。因此，获取文档ID是获取其关联标签的前提步骤。当然，您可以使用其他方法（如通过archive/list接口搜索文档，然后从搜索结果中提取ID）来获取文档ID，但最终都需要文档ID才能调用tag/list接口。