#F5F5F5

Entrega contenido estructurado a cualquier app con la API de contenido de GraphQL

#F5F5F5

Agiliza la distribución de contenido omnicanal con la API de GraphQL y Adobe Experience Manager Sites

Adobe Experience Manager Sites brinda al personal de desarrollo una integración nativa con la API de GraphQL, diseñada para agilizar la distribución de contenido estructurado en páginas web, aplicaciones y otros canales digitales. Esta característica permite a los equipos ampliar a escala las operaciones de contenido y satisfacer la creciente demanda de experiencias dinámicas y personalizadas.

La API de GraphQL agiliza la distribución de contenido

Las API de REST heredadas suelen saturar las aplicaciones con numerosas llamadas al servidor o transferencia excesivas de datos, lo que ralentiza el rendimiento y complica el desarrollo. Experience Manager Sites resuelve este problema con una API nativa de GraphQL, que permite a los equipos de aplicaciones o interfaz consultar el contenido exacto que necesitan mediante una única solicitud eficiente.

Experience Manager Sites es el CMS empresarial preferido, y combina funciones modernas de distribución con una gestión estructurada del contenido. Su integración con GraphQL elimina las rígidas estructuras de puntos finales y favorece una distribución de contenido ampliable y de alto rendimiento a través de sitios web, aplicaciones y experiencias digitales.

La API de GraphQL de Experience Manager Sites está diseñada para las arquitecturas componibles actuales y ofrece cargas de página más reducidas, un desarrollo más ágil y la flexibilidad que las empresas necesitan para satisfacer las cambiantes exigencias de la clientela a gran escala y con precisión.

La integración de la API de GraphQL mejora la creación de contenido

La API de GraphQL de Experience Manager está diseñada para exponer contenido estructurado, especialmente fragmentos de contenido, para la entrega headless en cualquier canal digital. Al actuar como un único endpoint flexible, permite que las aplicaciones cliente obtengan exactamente lo que necesitan, en el momento en que lo necesitan.

Este moderno enfoque basado en grafos ofrece ventajas claras con respecto a los métodos heredados de REST en las siguientes áreas:

  • Eficiencia. Recupera estructuras de contenido complejas y anidadas en una sola llamada a la API, sin necesidad de encadenar múltiples endpoints. Esto simplifica el desarrollo y acelera la carga de las páginas.
  • Precisión. El equipo de desarrollo consulta solo los campos necesarios, lo que reduce el tamaño de la carga útil y mejora el rendimiento, especialmente en redes móviles.
  • Flexibilidad. La API de GraphQL es independiente del frontend, lo que permite al equipo de desarrollo trabajar con cualquier framework (React, Angular, Vue y otros) sin depender de SDK propietarios.

API de GraphQL frente a la API de REST tradicional

Función

API de GraphQL de Experience Manager

API de REST tradicional

Estructura de puntos finales
Por lo general, un único punto final unificado de GraphQL por configuración.
Varios puntos finales por recurso o caso de uso.
Obtención de datos
Cada cliente especifica en la consulta los campos exactos que necesita.
El servidor define estructuras fijas de datos por punto final.
Obtención excesiva o insuficiente de datos
Se evita mediante la obtención de datos precisos.
Problema frecuente: puede obtenerse una cantidad excesiva o insuficiente de datos.
Volumen de solicitudes
Se recuperan datos relacionados (fragmentos anidados) en una misma solicitud.
A menudo se precisan varias solicitudes para obtener datos relacionados.
Almacenamiento en caché (solicitud estándar)
Los intermediarios no suelen almacenar en caché las peticiones POST.
Las peticiones GET se almacenan en caché fácilmente.
Almacenamiento en caché (práctica de Experience Manager)
Las consultas persistentes permiten hacer peticiones GET que pueden almacenarse en caché.
Las peticiones GET se almacenan en caché fácilmente.
Evolución de las API
El esquema puede evolucionar y es fácil añadir campos que no alteren la estructura.
La adición de campos puede resultar problemática y a menudo requiere la creación de versiones.

Funciones clave de GraphQL en Experience Manager Sites

La integración de la API de GraphQL con Experience Manager Sites ofrece numerosas funciones clave:

Generación del esquema de GraphQL

Experience Manager Sites simplifica el desarrollo descentralizado al generar automáticamente esquemas de GraphQL a partir de tus modelos de fragmentos de contenido, sin necesidad de crearlos de forma manual. A medida que los equipos de arquitectura de contenido definen o actualizan los modelos, Experience Manager traduce al instante esos cambios en un esquema de GraphQL totalmente tipificado y en tiempo real en el punto final correspondiente.

Esta generación dinámica de esquemas presenta las siguientes ventajas empresariales:

  • Tipado estricto y validación anticipada. El tipado basado en el esquema garantiza resultados predecibles y detecta consultas inválidas antes de su ejecución, lo que ahorra tiempo y reduce errores durante el desarrollo.
  • Introspección nativa. El equipo de desarrollo puede consultar el propio esquema, lo que habilita funciones como el autocompletado, la validación y la documentación en línea con herramientas de GraphQL.
  • Coherencia orientada al contenido. El esquema refleja la estructura real del contenido y actúa como fuente única de verdad. Esta estrecha alineación entre el equipo de autoría y el de desarrollo agiliza la colaboración y elimina la desincronización del esquema.

Al automatizar la generación de esquemas, Experience Manager Sites agiliza el desarrollo descentralizado, reduce los gastos de mantenimiento y facilita la distribución ampliable de contenido estructurado.

Consulta exactamente lo que necesites con GraphQL

GraphQL brinda a las aplicaciones cliente control total sobre la estructura y la especificidad de sus solicitudes de contenido. En Experience Manager Sites, el equipo de desarrollo utiliza consultas de GraphQL para recuperar de manera eficiente contenido estructurado a partir de fragmentos de contenido, adaptado a las necesidades de cada aplicación. Entre sus principales funciones se incluyen:

  • Selección de campos. Recupera solo los campos que se necesitan, sin más, lo que minimiza el tamaño de la carga útil y potencia el rendimiento.
  • Acceso segmentado a fragmentos. Consulta fragmentos de contenido individuales por ruta o devuelve listas por tipo de modelo.
  • Filtrado avanzado. Ajusta los resultados aplicando filtros a los valores de campo.
  • Recuperación de contenido anidado. Obtén fragmentos de contenido anidados o vinculados en una sola consulta, ideal para relaciones de contenido complejas.
  • Contenido localizado y variantes. Solicita variaciones específicas de un fragmento para ofrecer experiencias personalizadas, regionales o adaptadas a cada canal.
  • Consultas dinámicas con variables. Incorpora valores como identificadores o términos de búsqueda en tiempo de ejecución para crear consultas flexibles y reutilizables sin necesidad de reescribir la estructura.

Gracias a la integración de GraphQL en Sites, los equipos de desarrollo disfrutan de una interfaz potente e intuitiva para acceder al contenido de forma descentralizada y aumentar así la velocidad, escalabilidad y precisión.

Configuración segura y ampliable de puntos finales de GraphQL

En Experience Manager Sites, las consultas de GraphQL se envían a puntos finales designados, es decir, URL específicas que sirven de punto de acceso para distribuir contenido de forma descentralizada. A diferencia de las API de REST con múltiples puntos finales para distintos recursos, GraphQL centraliza las interacciones a través de un único punto final por configuración, lo que simplifica el desarrollo y mejora la capacidad de mantenimiento.

Para garantizar una correcta gobernanza, la persona a cargo de la administración debe configurar, activar y publicar de forma explícita los puntos finales de GraphQL de Sites. Este enfoque refuerza la seguridad y el control antes de exponer el contenido estructurado. Sites admite dos tipos de puntos finales de GraphQL:

  • Endpoint global. Permite acceder a los modelos de fragmentos de contenido definidos en la configuración global, junto con los modelos de cualquier configuración específica del sitio. Ideal para estructuras de contenido compartidas y reutilizadas en distintos proyectos.
  • Endpoint específico del sitio. Vinculado a la configuración de un sitio o proyecto en particular, este endpoint restringe el acceso solo a los modelos de esa configuración y a los del ámbito global, lo que garantiza un aislamiento claro y minimiza la exposición entre proyectos.

Esta flexible configuración permite a las empresas gestionar con precisión la distribución de contenido entre marcas, regiones o unidades empresariales, lo que garantiza la escalabilidad sin poner en peligro la seguridad ni la claridad.

Navegación al punto final de GraphQL

Preguntas frecuentes

¿En qué se diferencian las API de GraphQL y las de REST?
GraphQL es un lenguaje de consulta moderno para API que permite a la clientela solicitar los datos exactos que necesita desde un único punto final, mientras que las API de REST dependen de múltiples puntos finales y estructuras fijas de datos. Esto hace que GraphQL sea más eficiente, flexible y adecuado para aplicaciones dinámicas con mucho contenido.

Más información sobre la API de GraphQL

Content as a Service v3 - experience-manager-sites - Wednesday, May 21, 2025 at 13:55