如何根据当前文档的`id`通过其他接口获取“上一个”或“下一个”文档的链接和标题？

在内容型网站中，用户往往希望能够方便地从当前文章跳转到上一篇或下一篇文章，这种连贯的阅读体验对于提升用户满意度和网站的PV（页面浏览量）至关重要。安企CMS (AnQiCMS) 为我们提供了简洁高效的API接口来实现这一功能，让开发者能够轻松地在文章详情页集成“上一篇/下一篇”导航。

巧妙利用API，构建文章导航

安企CMS针对上一篇和下一篇文章的获取，提供了非常直观的接口：/api/archive/prev 和 /api/archive/next。这两个接口的设计目的就是为了解决文章详情页的上下导航需求，它们只需要当前文章的id作为参数，便能返回相邻文章的链接和标题。

要获取当前文章的上一篇，我们可以调用 /api/archive/prev 接口。您只需传入当前正在阅读的文章的 id，安企CMS便会返回该 id 对应的上一篇文章的详细信息。返回的数据中包含了 id、title（文章标题）和 link（文章链接）等关键字段。通过 link 字段，我们就能直接构建出跳转到上一篇文章的超链接，而 title 则可以作为导航按钮的文本内容。

同样地，要获取当前文章的下一篇，我们使用 /api/archive/next 接口。它的调用方式与获取上一篇完全相同，也只需要提供当前文章的 id。接口会返回下一篇文章的 id、title 和 link。

实际操作中的逻辑考量

在实际开发中，当您的网站模板需要展示文章的上下页导航时，可以按照以下步骤进行处理：

1. 获取当前文章ID： 当用户访问任何一篇文章的详情页时，我们首先需要从页面URL或通过 /api/archive/detail 接口的响应中，拿到当前文章的唯一标识符 id。
2. 发起API请求：
   • 向 {域名地址}/api/archive/prev 发送一个 GET 请求，并在请求参数中带上当前文章的 id。
   • 同时，向 {域名地址}/api/archive/next 发送一个 GET 请求，同样带上当前文章的 id。
3. 处理API响应：
   • 对于这两个请求的响应，我们需要检查返回的 data 字段。
   • 如果 data 字段不为 null，这意味着存在上一篇或下一篇文章。此时，您可以从 data 对象中提取 title 字段作为导航按钮的文本，并提取 link 字段作为导航按钮的跳转地址。
   • 如果 data 字段为 null，则表示当前文章已经是该序列中的第一篇（对于上一篇导航）或最后一篇（对于下一篇导航）。在这种情况下，您可以选择隐藏相应的导航按钮，或者将其置灰，告知用户已无更多内容。

通过这样的机制，您的网站可以为用户提供流畅、无缝的文章切换体验，极大地提升了内容的易发现性和用户的阅读时长。

常见问题 (FAQ)

1. 如果当前文章是分类中的第一篇或最后一篇，archive/prev 或 archive/next 接口会返回什么？

当您请求上一篇文章，而当前文章已经是序列中的第一篇时，/api/archive/prev 接口的 data 字段会返回 null。同理，当请求下一篇文章，而当前文章是最后一篇时，/api/archive/next 接口的 data 字段也会返回 null。这让您可以轻松地判断并相应地处理导航按钮的显示状态。

2. archive/prev 和 archive/next 接口返回的文章是根据什么顺序排列的？它们会考虑文章的分类吗？

这两个接口通常会根据文章的 id（默认为递增）或发布时间 created_time 在其所属的相同类别或整个文档库中查找相邻的文章。安企CMS的这两个接口设计上会智能地在当前文档的上下文（例如：同一分类、同一模块）中寻找前后文档，以确保导航的逻辑性。如果需要更精细的控制（例如只在特定条件下按创建时间排序），可能需要结合 /api/archive/list 接口进行自定义查询。

3. 除了标题和链接，我还能从 archive/prev 或 archive/next 接口的响应中获取其他文章信息吗？

可以的。archive/prev 和 archive/next 接口在 data 字段中返回的实际上是一个完整的文档对象，与 /api/archive/detail 接口返回的 data 结构是相同的。这意味着您不仅可以获取到 id、title 和 link，还能得到诸如 thumb（缩略图）、description（简介）、views（浏览量）等所有可用的文章字段信息。这为您在设计上下页导航时提供了更大的灵活性，例如可以在导航按钮旁显示缩略图或简短描述。