Acesso e entrega de Fragmentos de conteúdo - Guia de início rápido do Headless accessing-delivering-content-fragments

Saiba como usar a API REST do AEM Assets para gerenciar fragmentos de conteúdo e a API do GraphQL para entrega headless do conteúdo do fragmento de conteúdo.

O que são as APIs REST do GraphQL e do Assets? what-are-the-apis

Agora que criou alguns fragmentos de conteúdo, você pode usar as APIs do AEM para entregá-los de forma headless.

O restante deste guia terá como foco o acesso ao GraphQL e a entrega de Fragmentos de conteúdo.

Como fornecer um fragmento de conteúdo usando o GraphQL how-to-deliver-a-content-fragment

Os arquitetos da informação devem projetar consultas para seus endpoints de canal para fornecer conteúdo. Considere essas consultas apenas uma vez por endpoint, por modelo. Para este guia de introdução, crie apenas um.

  1. Faça logon no AEM e acesse a Interface GraphiQL:

    • Por exemplo: http://<host>:<port>/aem/graphiql.html.
  2. O GraphiQL é um editor de consultas no navegador para o GraphQL. Você pode usá-lo para criar consultas para recuperar Fragmentos de conteúdo e entregá-los de forma headless como JSON.

    • O painel esquerdo permite criar a consulta.

    • O painel direito exibe os resultados.

    • O Editor de consultas tem recursos de autocompletar código e teclas de atalho para executar a consulta com facilidade.

      Editor do GraphiQL

  3. Supondo que o modelo criado era chamado person com os campos firstName, lastName e position, podemos criar uma consulta simples para recuperar o conteúdo do Fragmento de conteúdo.

    code language-text
    query
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Insira a consulta no painel esquerdo.

  5. Clique no ícone Executar Consulta (seta para a direita) ou use a tecla de atalho Ctrl-Enter e os resultados serão exibidos como JSON no painel direito.
    Resultados do GraphiQL

  6. Clique em:

    • Documentação na parte superior direita da página para mostrar a documentação contextual para ajudá-lo a criar suas consultas que se adaptam aos seus próprios modelos.

    • Histórico na barra de ferramentas superior para mostrar consultas anteriores.

    • Salvar como e Salvar para salvar suas consultas. Depois disso, você poderá listá-las e recuperá-las do painel Consultas Persistentes e do Publish.

      Documentação do GraphiQL

O GraphQL permite consultas estruturadas que podem direcionar não apenas conjuntos de dados específicos ou objetos de dados individuais, mas também fornecer elementos específicos dos objetos, resultados aninhados, oferecer suporte para variáveis de consulta e muito mais.

O GraphQL pode evitar solicitações de API iterativas e entrega excessiva. Em vez disso, permite a entrega em massa exatamente do que é necessário para a renderização, como resposta a uma única consulta de API. O JSON resultante pode ser usado para fornecer dados a outros sites ou aplicativos.

Próximas etapas next-steps

Pronto! Agora você tem uma compreensão básica do gerenciamento de conteúdo headless no AEM. Existem muitos outros recursos onde é possível se aprofundar para obter um entendimento abrangente dos recursos disponíveis.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2