#F5F5F5

Distribuye contenido estructurado a gran escala con la API 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 el contenido estructurado, especialmente los fragmentos de contenido, para una distribución descentralizada a través de cualquier canal digital. La API constituye un único punto final flexible que permite que las aplicaciones cliente obtengan exactamente la información que necesitan en el momento oportuno.

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 API y olvídate de encadenar múltiples puntos finales. De este modo, simplificarás el desarrollo y agilizarás los tiempos de carga de las páginas.
  • Precisión. Los equipos de desarrollo consultan únicamente los campos que necesitan, lo que reduce la carga de datos y mejora el rendimiento, sobre todo en las redes móviles.
  • Flexibilidad. La API de GraphQL no depende de aplicaciones ni interfaces, lo que permite a los equipos crear con cualquier marco de trabajo (React, Angular o Vue, entre otros) sin tener que limitarse a SDK exclusivos.

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:

  • Tipificación robusta y validación anticipada. La tipificación de esquemas garantiza la obtención de resultados predecibles y detecta consultas no válidas antes de la ejecución, lo que permite ahorrar tiempo y reducir errores durante el desarrollo.
  • Introspección integrada. Los equipos de desarrollo pueden consultar el propio esquema y emplear funciones como el autocompletado, la validación y la documentación en línea con herramientas de GraphQL.
  • Uniformidad basada en el contenido. El esquema refleja la estructura real del contenido y ejerce de única fuente de confianza. Esta estrecha coordinación entre equipos de creación y desarrollo optimiza la colaboración y evita la desviación de los esquemas.

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 todo el control de la estructura y especificidad de las solicitudes de contenido. En Experience Manager Sites, los equipos de desarrollo utilizan las consultas de GraphQL para extraer con eficiencia contenido estructurado a partir de fragmentos de contenido, todo ello según los requisitos de su aplicación. Estas son algunas de las funciones clave:

  • Selección de campos. Recupera únicamente los campos que necesites para minimizar la carga de datos e impulsa el rendimiento.
  • Acceso a fragmentos específicos. Consulta fragmentos de contenido individuales por ruta u obtén listas por tipo de modelo.
  • Filtros avanzados. Ajusta los resultados aplicando filtros a valores de campo.
  • Recuperación de contenido anidado. Obtén fragmentos de contenido vinculado o anidado en una misma consulta, lo cual resulta ideal para relaciones complejas de contenido.
  • Contenido localizado y con variantes. Solicita variaciones específicas de un fragmento para brindar experiencias personalizadas, regionales o específicas para un canal.
  • Consultas dinámicas con variables. Introduce valores como ID o términos de búsqueda durante la ejecución para crear consultas flexibles y reutilizables sin 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:

  • Punto final global. Concede acceso a modelos de fragmentos de contenido definidos en la configuración global, así como a modelos de cualquier configuración específica de sitio. Esta opción es perfecta para las estructuras de contenido compartidas que se reutilizan en varios proyectos.
  • Punto final específico de sitio. Este punto final está vinculado a una configuración de un sitio o proyecto específicos y restringe el acceso a los modelos de esa configuración, así como a los que se encuentran en el alcance global, lo que brinda 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