Livraison de contenu structuré vers toutes les applications avec l’API GraphQL

Les anciennes API REST tendent à alourdir les applications avec de multiples appels serveur ou des volumes de données trop importants, ce qui nuit aux performances et complique le développement. Avec son API GraphQL, Experience Manager Sites permet aux équipes front-end d’interroger précisément le contenu souhaité en une seule requête.

Adopté comme CMS de référence par de nombreuses entreprises, Experience Manager Sites allie gestion de contenu structuré et fonctionnalités de diffusion innovantes. En éliminant les structures de point d’entrée rigides, l’intégration de GraphQL simplifie la diffusion de contenu évolutif et percutant sur tous les canaux digitaux.

Pensée pour les architectures composables actuelles, l’API GraphQL accélère le chargement des pages, facilite le développement et apporte la flexibilité nécessaire pour répondre à l’évolution des attentes de la clientèle, à grande échelle et avec précision.

L’API GraphQL intégrée à Experience Manager expose du contenu structuré — en particulier des fragments de contenu — pour assurer une livraison headless sur l’ensemble des canaux numériques. En tant que point de terminaison unique et flexible, elle permet aux applications clientes de récupérer exactement les données dont elles ont besoin, au moment voulu.

Cette approche moderne basée sur des graphes offre plusieurs atouts par rapport aux méthodes REST :

• Efficacité. Récupérez des structures de contenu complexes et imbriquées en un seul appel API, sans multiplier les points de terminaison. Le développement s’en trouve simplifié et le chargement des pages considérablement accéléré.
• Précision. Les développeurs et développeuses n’interrogent que les champs nécessaires, ce qui allège les charges utiles et améliore les performances, notamment sur les réseaux mobiles.
• Flexibilité. L’API GraphQL est indépendante du front-end : les équipes peuvent développer avec le framework de leur choix — React, Angular, Vue et bien d’autres — sans être liées à des SDK propriétaires.

Générez des schémas GraphQL.

Experience Manager Sites facilite le développement headless en générant automatiquement des schémas GraphQL à partir de vos modèles de fragments de contenu, sans intervention de votre part. À chaque mise à jour ou définition d’un modèle par les architectes de contenu, Experience Manager traduit instantanément ces changements en un schéma GraphQL dynamique et fortement typé sur le point d’entrée correspondant.

Ce fonctionnement offre des avantages adaptés aux exigences de l’entreprise :

• Typage fort et validation précoce. Le typage imposé par le schéma garantit des résultats prévisibles et détecte les requêtes invalides avant leur exécution — pour gagner du temps et réduire les erreurs en phase de développement.
• Introspection native. Les développeurs et développeuses peuvent interroger le schéma lui-même, activant ainsi des fonctionnalités telles que l’autocomplétion, la validation et la documentation intégrée via les outils GraphQL.
• Cohérence pilotée par le contenu. Le schéma reflète la structure réelle du contenu et sert de source unique de référence. Cette concordance étroite entre les équipes éditoriales et techniques fluidifie la collaboration et élimine toute dérive du schéma.

En automatisant la génération de schémas, Experience Manager Sites accélère le développement headless, réduit les coûts de maintenance et fait le lien entre contenu structuré et diffusion évolutive.

Grâce à GraphQL, interrogez précisément le contenu souhaité.

GraphQL offre aux applications clientes un contrôle total sur la structure et la précision de leurs demandes de contenu. Dans Experience Manager Sites, les développeurs et développeuses s’appuient sur des requêtes GraphQL pour récupérer efficacement du contenu structuré depuis des fragments de contenu — le tout adapté aux besoins de leur application. Les fonctionnalités clés incluent :

• Sélection de champs. Récupérez uniquement les champs nécessaires — rien de plus — pour minimiser la taille de la charge utile et optimiser les performances.
• Accès ciblé aux fragments. Interrogez des fragments de contenu individuels par chemin d’accès ou renvoyez des listes par type de modèle.
• Filtrage avancé. Affinez les résultats en appliquant des filtres aux valeurs de champs.
• Récupération de contenu imbriqué. Extrayez des fragments de contenu imbriqués ou liés en une seule requête — idéal pour les relations de contenu complexes.
• Contenu localisé et décliné. Demandez des variations spécifiques d’un fragment pour diffuser des expériences personnalisées, régionales ou propres à chaque canal.
• Requêtes dynamiques avec variables. Injectez des valeurs — identifiants ou termes de recherche — au moment de l’exécution pour créer des requêtes flexibles et réutilisables, sans modifier la structure.

L’intégration de l’API GraphQL offre une interface puissante et intuitive pour accéder au contenu headless, avec davantage de rapidité, d’évolutivité et de précision.

Dans Experience Manager Sites, les requêtes GraphQL sont envoyées vers des points d’entrée dédiés. Il s’agit d’URL qui servent de points d’accès pour la diffusion de contenu en mode headless. Contrairement aux API REST qui multiplient les points d’entrée selon les ressources, GraphQL centralise les interactions via un unique point d’entrée par configuration, ce qui simplifie le développement et la maintenance.

Pour assurer une gouvernance efficace, les points d’entrée de l’API GraphQL doivent être explicitement configurés, activés et publiés par l’équipe d’administration. Cette approche renforce les contrôles et la sécurité avant d’exposer le contenu structuré. Experience Manager Sites prend en charge deux types de points d’entrée GraphQL :

• Point de terminaison global. Donne accès aux modèles de fragments de contenu définis dans la configuration globale, ainsi qu’aux modèles issus de toutes les configurations propres à chaque site. Idéal pour les structures de contenu partagées et réutilisées dans plusieurs projets.
• Point de terminaison propre au site. Associé à la configuration d’un site ou d’un projet particulier, ce point de terminaison limite l’accès aux seuls modèles de cette configuration ainsi qu’à ceux de la portée globale, garantissant une isolation nette et réduisant l’exposition entre projets.

Cette configuration flexible vous permet de gérer la diffusion du contenu avec précision selon les marques, les régions ou les divisions. Cela garantit une grande évolutivité sans transiger sur la sécurité ni sur la clarté.