Criar uma solicitação de API - Configuração Headless accessing-delivering-content-fragments
Saiba como usar a API GraphQL para a entrega headless do conteúdo do Fragmento de conteúdo e a API REST do AEM Assets para gerenciar Fragmentos 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.
- A API GraphQL permite criar solicitações para acessar e fornecer Fragmentos de conteúdo. Essa API oferece o conjunto mais robusto de recursos para consultar e consumir conteúdo de Fragmentos de conteúdo.
- Para usar a API, defina e habilite os pontos de acesso no AEMe, se necessário, na Interface GraphiQL instalada.
- A API REST do Assets permite criar e modificar Fragmentos de conteúdo (e outros ativos).
O restante deste guia terá como foco o acesso ao GraphQL e a entrega de Fragmentos de conteúdo.
Habilitar endpoint GraphQL enable-graphql-endpoint
Para que as APIs GraphQL possam ser usadas, é necessário criar um endpoint GraphQL.
-
Navegue até Ferramentas, Geral e, em seguida, selecione GraphQL.
-
Selecione Criar.
-
A caixa de diálogo Criar novo ponto de acesso de GraphQL será aberta. Aqui, é possível especificar:
- Nome: nome do endpoint; é possível inserir qualquer texto.
- Usar esquema do GraphQL fornecido por: use a lista suspensa para selecionar a configuração necessária.
-
Confirme com Criar.
-
No console, um Caminho será exibido com base na configuração criada anteriormente. Esse caminho é usado para executar consultas do GraphQL.
code language-none /content/cq:graphql/<configuration-name>/endpoint
Para obter mais detalhes sobre como habilitar endpoints do GraphQL, consulte Gerenciar endpoints do GraphQL no AEM.
Consultar conteúdo usando GraphQL com o GraphiQL
Os arquitetos da informação projetam consultas para seus pontos de acesso de canal para fornecer conteúdo. Considere essas consultas apenas uma vez por ponto de acesso, por modelo. Para os propósitos deste guia de introdução, só é necessário criar um.
GraphiQL é um IDE, incluído no seu ambiente do AEM; ele se torna acessível/visível após configurar seus pontos de acesso.
-
Faça logon no AEM as a Cloud Service e acesse a interface GraphiQL:
É possível acessar o editor de consultas por meio de:
- Ferramentas > Geral > Editor de Consultas do GraphQL
- diretamente; por exemplo,
http://localhost:4502/aem/graphiql.html
-
O GraphiQL IDE é um editor de consultas no navegador para GraphQL. Você pode usá-lo para criar consultas para recuperar fragmentos de conteúdo e entregá-los como JSON sem periféricos.
- O menu suspenso no canto superior direito permite selecionar o endpoint.
- Um painel à esquerda lista as consultas persistentes (quando disponíveis)
- O painel central esquerdo permite criar a consulta.
- O painel central direito exibe os resultados.
- O Editor de consultas tem recursos de autocompletar código e teclas de atalho para executar a consulta com facilidade.
-
Supondo que o modelo criado era chamado
person
com os camposfirstName
,lastName
eposition
, 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 } } }
-
Insira a consulta no painel esquerdo.
-
Clique no botão Executar Consulta ou use a tecla de atalho
Ctrl-Enter
e os resultados serão exibidos como JSON no painel direito.
-
No canto superior direito da página, clique no link Documentos para mostrar a documentação contextual para que você possa criar suas consultas que se adaptem aos seus próprios modelos.
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 em excesso e, em vez disso, permite a entrega em massa exatamente do que é necessário para renderizar em 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.
- Fragmentos de conteúdo - Para obter detalhes sobre a criação e o gerenciamento dos Fragmentos de conteúdo
- Suporte a fragmentos de conteúdo na API HTTP do AEM Assets - Para obter detalhes sobre como acessar conteúdo do AEM diretamente pela API HTTP, por meio de operações CRUD (Criar, Ler, Atualizar, Excluir)
- API GraphQL - Para obter detalhes sobre como fornecer Fragmentos de conteúdo de forma headless