如何通过文档URL别名（`filename`）获取文档详情？
在安企CMS中，文档的URL别名（filename）是一个非常实用的功能，它不仅能让您的网站URL更加友好，提升搜索引擎优化（SEO）效果，还在内容获取方面提供了极大的便利。当您需要通过编程方式获取特定文档的详细信息时，AnQiCMS提供了简单直观的API接口。
核心功能揭秘：使用文档 URL 别名获取详情
要通过文档的URL别名来获取其全部详情，您主要会用到安企CMS的archive/detail接口。这个接口设计得非常灵活，允许您通过文档的唯一ID或者其设定的URL别名来精确检索内容。
设想一下，您的网站上有一篇关于“安企CMS入门指南”的文章，其URL别名可能被设定为anqi-cms-guide。当您想在自定义的页面模板、小程序或任何其他应用中展示这篇文章的完整内容时，便可以直接使用这个别名进行请求，而无需预先知道它的内部数据库ID。
如何构建请求以获取文档详情
请求文档详情的API地址通常是这样的：{域名地址}/api/archive/detail。其中，{域名地址}需要替换成您实际网站的域名。
这个接口的调用方法是GET，这意味着您可以通过URL参数来传递请求信息。核心参数有两个：id和filename。它们是互斥的，也就是说，您只需选择其中一个来标识您想获取的文档。
对于我们今天讨论的主题，您会使用filename参数。例如，如果您想获取URL别名为anqi-cms-guide的文档，您的请求URL会类似于：
https://www.yourdomain.com/api/archive/detail?filename=anqi-cms-guide
发送这样的GET请求后，安企CMS便会返回与该别名对应的文档所有详细信息。
深入理解返回数据结构
成功获取文档详情后，API会返回一个JSON格式的数据。这个数据包里包含了您所需的一切。通常，您会看到以下几个关键部分：
code和msg: 这两个字段是每个API响应的基础。code为0表示请求成功，msg会提供操作结果的文字说明。如果出现错误，它们也会给出相应的错误代码和原因。data对象: 这是所有文档详情的承载者。它包含了文档的基本属性，例如：id: 文档的唯一ID。title: 文档的标题。seo_title,keywords,description: 用于搜索引擎优化的元信息。url_token: 这就是我们传入的filename，也就是文档的URL别名。views,comment_count: 文档的浏览量和评论数。created_time,updated_time: 文档的发布和更新时间戳。
值得一提的是，文档的实际内容和分类信息会分别在
data.data和data.category这两个嵌套对象中。data.data.content: 文档的富文本内容，通常是HTML格式，可以直接在前端进行渲染展示。data.category: 包含文档所属分类的详细信息，如分类ID、分类名称（title）、分类URL别名（url_token）等。data.extra: 如果您的文档模型中设置了自定义字段，这些字段的内容将在这个extra对象中以键值对的形式呈现，例如{"author": {"name": "作者", "value": "AnqiCMS"}}。这使得您的内容可以拥有非常丰富的自定义属性。
通过解析这些返回数据，您可以灵活地在前端页面展示文档标题、简介、正文、发布时间，甚至是作者信息等自定义内容。
实际应用场景与优势
使用filename来获取文档详情，特别适用于以下情况：
- 构建前端页面: 当您在开发自定义前端界面时，如果您的路由设计是基于URL别名，那么直接通过
filename查询可以简化数据获取逻辑。 - SEO友好: 在前端框架如Vue、React或小程序中，生成SEO友好的URL时，
filename能更好地对应这些URL，保持前后端数据请求的一致性。 - 内容迁移或同步: 在进行内容导入或与第三方系统集成时，如果别名是作为唯一标识，那么使用
filename可以方便地定位和获取特定内容。
这种方式的优势在于，它提供了一种人类可读、易于管理且对搜索引擎友好的方式来引用和获取网站上的内容，比单纯使用数字ID更具语义化。
总结
安企CMS通过archive/detail接口，并结合filename参数，为您提供了一种高效、灵活且易于理解的方式来获取文档详情。无论是为了SEO优化、自定义开发，还是内容管理，掌握这一功能都将大大提升您的工作效率和网站的用户体验。
常见问题 (FAQ)
Q: 如果我没有为文档设置URL别名，还能使用
filename参数获取文档详情吗？ A: 不能。filename参数必须传入文档在安企CMS后台设置的URL别名才能生效。如果文档没有设置别名，或者您传入了错误的别名，API将无法找到对应的文档并返回错误信息。在这种情况下，您应该使用文档的唯一ID（id参数）来获取详情。Q:
filename和id参数同时传入时，会优先使用哪个？ A: 根据提供的文档说明，id和filename是“二选一”的参数。这意味着您只需传入其中一个即可。通常情况下，API会有一个内部的优先级判断逻辑，但为了确保请求的明确性和效率，建议您每次只传入一个有效的标识参数。如果您明确知道文档ID，使用ID可能会稍微直接一些；如果您更倾向于语义化URL，则使用filename。Q: 返回数据中的
extra字段具体可以用来做什么？ A:extra字段是安企CMS非常灵活的一个特性，它用于存放您在后台为文档模型自定义的额外字段数据。例如，如果您为“文章”模型添加了“作者”、“来源”或“阅读时长”等自定义字段，那么这些字段的值就会在extra中返回。通过解析extra，您可以在前端展示这些丰富的自定义信息，从而更好地满足多样化的内容展示需求。