Acceso y entrega de fragmentos de contenido Guía de inicio rápido sin encabezado accessing-delivering-content-fragments
Aprenda a utilizar la API de REST de AEM Assets para administrar fragmentos de contenido y la API de GraphQL para la entrega sin encabezado de contenido de fragmentos de contenido.
¿Qué son las API de REST de GraphQL y Assets? what-are-the-apis
Ahora que ha creado algunos fragmentos de contenido, puede utilizar las API de AEM para entregarlas sin problemas.
- La API de GraphQL le permite crear solicitudes para acceder a fragmentos de contenido y enviarlos.
- AEM Para usar esto, los puntos de conexión deben definirse y habilitarse en la interfaz de y, si es necesario, la interfaz de GraphiQL debe instalarse🔗.
- La API de REST de Assets le permite crear y modificar fragmentos de contenido (y otros recursos).
El resto de esta guía se centra en el acceso a GraphQL y la entrega de fragmentos de contenido.
Cómo entregar un fragmento de contenido mediante GraphQL how-to-deliver-a-content-fragment
Los arquitectos de la información deben diseñar consultas para sus extremos de canal para entregar contenido. Considere estas consultas solo una vez por extremo, por modelo. Para esta guía de introducción, cree solo una.
-
AEM Inicie sesión en la interfaz de GraphiQL y acceda a ella:
- Por ejemplo:
http://<host>:<port>/aem/graphiql.html
.
- Por ejemplo:
-
GraphiQL es un editor de consultas en el explorador para GraphQL. Puede utilizarlo para generar consultas, recuperar fragmentos de contenido y entregarlos sin problemas como JSON.
-
El panel izquierdo le permite generar la consulta.
-
El panel derecho muestra los resultados.
-
El editor de consultas incluye la finalización del código y teclas de función para ejecutar fácilmente la consulta.
-
-
Suponiendo que el modelo que hemos creado se llamara
person
con camposfirstName
,lastName
yposition
, podemos generar una consulta sencilla para recuperar el contenido de nuestro fragmento de contenido.code language-text query { personList { items { _path firstName lastName position } } }
-
Introduzca la consulta en el panel izquierdo.
-
Haga clic en el icono Ejecutar consulta (flecha derecha) o use la tecla de acceso directo
Ctrl-Enter
y los resultados se mostrarán como JSON en el panel derecho.
-
Haga clic:
-
Documentos en la parte superior derecha de la página para mostrar la documentación en contexto que le ayudará a crear consultas que se adapten a sus propios modelos.
-
Historial en la barra de herramientas superior para mostrar consultas anteriores.
-
Guardar como y Guardar para guardar sus consultas, después de lo cual podrá enumerarlas y recuperarlas desde el panel Consultas persistentes y Publish.
-
GraphQL permite consultas estructuradas que pueden dirigirse no solo a conjuntos de datos específicos u objetos de datos individuales, sino que también pueden proporcionar elementos específicos de los objetos, resultados anidados, compatibilidad con variables de consulta y mucho más.
GraphQL puede evitar las solicitudes de API iterativas y el exceso de entrega. En su lugar, permite la entrega masiva de exactamente lo que se necesita para procesar como respuesta a una sola consulta de API. El JSON resultante se puede utilizar para entregar datos en otros sitios o aplicaciones.
Siguientes pasos next-steps
¡Eso es todo! Ahora tiene una comprensión básica de la administración de contenido sin encabezado en AEM. Hay muchos más recursos en los que puede profundizar para comprender las funciones disponibles.
- AEM Explorador de configuración - Para obtener detalles acerca del Explorador de configuración de la
- Fragmentos de contenido: para obtener más información acerca de la creación y administración de fragmentos de contenido
- IDE de GraphiQL para obtener más información sobre el uso del IDE de GraphiQL
- Consultas persistentes para obtener más información sobre las Consultas persistentes
- Compatibilidad con fragmentos de contenido en la API HTTP de AEM Assets: para obtener más información sobre el acceso al contenido de AEM directamente a través de la API HTTP, mediante las operaciones CRUD (Crear, Leer, Actualizar, Eliminar)
- API de GraphQL: para obtener más información sobre cómo enviar fragmentos de contenido sin encabezado