访问和交付内容片段Headless快速入门指南

了解如何使用AEM Assets REST API管理内容片段，以及使用GraphQL API无头交付内容片段内容。

什么是 GraphQL 和 Assets REST API？

现在您已经创建了一些内容片段，您可以使用 AEM 的 API 以 Headless 的方式投放它们。

本指南的剩余部分侧重于 GraphQL 访问和内容片段投放。

如何使用GraphQL投放内容片段

信息架构师需要为其渠道端点设计查询来投放内容。这些查询通常只需要为每个模型的每个端点考虑一次。对于本指南快速入门，我们只需要创建一个。

  1. 登录AEM并访问 GraphiQL接口：

    • 例如：http://<host>:<port>/aem/graphiql.html。

  2. GraphiQL 是用于 GraphQL 的浏览器中查询编辑器。您可以使用它来构建查询，检索内容片段，以便通过 JSON 格式以 Headless 方式交付。

    • 左侧窗格允许您构建查询。

    • 右侧窗格显示结果。

    • 查询编辑器具备代码完成和热键功能，可以轻松地执行查询。

      GraphiQL 编辑器

  3. 假定我们创建的模型名为 person，带有字段 firstName、lastName 和 position，我们可以构建简单的查询来检索内容片段的内容。

    query
{
  personList {
    items {
      _path
      firstName
      lastName
      position
    }
  }
}

  4. 在左侧面板中输入查询。

  5. 单击 执行查询 （向右箭头）图标或使用 Ctrl-Enter 热键和结果以JSON格式显示在右侧面板中。
    GraphiQL 结果

  6. 单击:

    • 文档 以显示上下文文档，帮助您构建适应您自己的模型的查询。

    • 历史记录 顶部工具栏中显示之前的查询。

    • 另存为 和 保存 以保存查询，之后可以从以下位置列出和检索查询： 持久查询 面板和 Publish.

      GraphiQL 文档

GraphQL 启用结构化查询，不仅针对特定数据集或者单独的数据对象，而且还可以提供对象的特定元素，嵌套结果，提供查询变量支持，以及诸多功能。

GraphQL 可以避免迭代 API 以及过度投放，而是允许作为对单个 API 查询的响应，批量精确投放所需呈现的内容。生成的 JSON 可用于向其他站点或应用程序提供数据。

后续步骤

就是这样！现在，您已对 AEM 中的 Headless 内容管理有了基本了解。当然，其中还有很多资源供您深入研究，以全面了解可用的功能。

在此页面上