访问和传送内容片段无头快速入门指南

了解如何使用AEM Assets REST API管理内容片段和GraphQL API来无头地交付内容片段内容。

什么是GraphQL和资产REST API?

现在,您已创建了一些内容片段, 您可以使用AEM API无头地提供它们。

本指南的其余部分将重点介绍GraphQL访问和内容片段交付。

如何使用GraphQL交付内容片段

信息架构师需要为其渠道端点设计查询才能交付内容。 通常,每个模型的每个端点只需要考虑一次这些查询。 在本快速入门指南中,我们只需创建一个。

  1. 登录AEMas a Cloud Service并访问GraphiQL界面:

    • 例如: https://<host>:<port>/content/graphiql.html.
  2. GraphiQL是GraphQL的浏览器内查询编辑器。 您可以使用它来构建查询以检索内容片段,以JSON形式直接交付它们。

    • 利用左侧面板,可构建查询。

    • 右侧面板会显示结果。

    • 查询编辑器具有代码完成和热键功能,可轻松执行查询。

      GraphiQL编辑器

  3. 假设我们创建的模型名为 person 带字段 firstName, lastNameposition,我们可以构建一个简单查询,以检索内容片段的内容。

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. 在左侧面板中输入查询。
    GraphiQL查询

  5. 单击 执行查询 按钮或使用 Ctrl-Enter 热键和结果在右侧面板中显示为JSON。
    GraphiQL结果

  6. 单击 文档 链接(位于页面右上方)以显示上下文文档,以帮助您构建可适应您自己模型的查询。
    GraphiQL文档

GraphQL支持结构化查询,这些查询不仅可以定向特定数据集或单个数据对象,还可以提供对象的特定元素、嵌套结果、支持查询变量等。

GraphQL可以避免迭代API请求和过度交付,相反,允许批量交付呈现为单个API查询响应所需的确切内容。 生成的JSON可用于将数据交付到其他网站或应用程序。

后续步骤

就是这样!现在,您对AEM中的无外设内容管理有了基本的了解。 当然,您还可以使用更多资源来更深入地了解可用功能。

  • 配置浏览器 — 有关AEM配置浏览器的详细信息
  • 内容片段 — 有关创建和管理内容片段的详细信息
  • AEM Assets HTTP API中的内容片段支持 — 有关通过CRUD操作(创建、读取、更新、删除)直接通过HTTP API访问AEM内容的详细信息
  • GraphQL API — 有关如何无头提交内容片段的详细信息

在此页面上