#F5F5F5

Déployez du contenu structuré à grande échelle avec l’API GraphQL.

#F5F5F5

Accélérez la diffusion de contenu omnicanal à l’aide de l’API GraphQL et d’Adobe Experience Manager Sites.

L’intégration native de l’API GraphQL avec Adobe Experience Manager Sites simplifie la diffusion de contenu structuré sur l’ensemble des canaux digitaux (web, applications et autres). Permettez ainsi à vos équipes de développer leurs activités de création tout en répondant à la demande croissante en matière d’expériences client dynamiques et personnalisées.

L’API GraphQL simplifie la diffusion de contenu.

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’intégration de l’API GraphQL améliore la création de contenu.

L’API GraphQL est conçue pour exposer le contenu structuré, en particulier les fragments de contenu, afin de le diffuser en mode headless sur tous les canaux digitaux. Agissant comme un point d’entrée unique et flexible, elle permet aux applications client de récupérer précisément ce 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é. La récupération de structures de contenu imbriquées et complexes en un seul appel API, sans avoir à multiplier les points d’entrée, simplifie le développement et accélère le chargement des pages.
  • Précision. Les requêtes portent uniquement sur les champs nécessaires, ce qui réduit la charge utile et améliore les performances, en particulier sur les réseaux mobiles.
  • Souplesse. L’API GraphQL est indépendante des interfaces front-end, ce qui vous permet d’utiliser les outils souhaités (React, Angular, Vue, etc.) sans être tributaire des kits SDK.

Qu’est-ce qui différencie l’API GraphQL d’une API REST classique ?

Fonctionnalité

API GraphQL

API REST classique

Structure de point d’entrée
Généralement, un seul point d’entrée par configuration
Plusieurs points d’entrée par ressource ou par cas d’usage
Extraction des données
Le client indique uniquement les champs nécessaires dans la requête.
Le serveur définit une structure de données fixe par point d’entrée.
Sur-extraction ou sous-extraction
Risque inexistant grâce à la précision des données renvoyées
Risque courant, avec trop ou trop peu de données renvoyées
Volume de requêtes
Extraction des données associées (fragments imbriqués) en une seule requête
Extraction des données associées en plusieurs requêtes
Mise en cache (requête standard)
Requêtes POST généralement non mises en cache par les intermédiaires
Requêtes GET facilement mises en cache
Mise en cache (avec Experience Manager)
Mise en cache des requêtes GET possible grâce à la persistance des requêtes
Requêtes GET facilement mises en cache
Évolution de l’API
Évolution possible du schéma ; ajout de champs facilité, sans interruption
Ajout de champs parfois source d’interruption ; gestion des versions souvent nécessaire

Quelles sont les fonctionnalités offertes par l’intégration de l’API GraphQL avec Experience Manager Sites ?

Découvrez les principales fonctionnalités de l’intégration de l’API GraphQL avec Experience Manager Sites.

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 :

  • Schéma fortement typé et validation anticipée. La création d’un schéma typé garantit des résultats prévisibles et détecte les requêtes invalides avant leur exécution, ce qui fait gagner du temps et limite les erreurs en phase de développement.
  • Introspection intégrée. Vos équipes de développement peuvent interroger le schéma et utiliser les différents outils GraphQL (saisie semi-automatique, validation, documentation en ligne).
  • Cohérence orientée contenu. Le schéma reflète la structure réelle du contenu, servant de source unique de vérité. Cette parfaite synergie entre les équipes de création et de développement facilite la collaboration et évite toute dérive.

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 client un contrôle total sur la structure et la précision de leurs requêtes de contenu. Vos équipes de développement créent des requêtes GraphQL dans Experience Manager Sites pour extraire, selon les besoins de leur application, le contenu structuré des fragments. Ses principales fonctionnalités sont les suivantes :

  • Sélection des champs. Récupérez uniquement les champs nécessaires, ce qui réduit la charge utile et booste les performances.
  • Accès ciblé aux fragments de contenu. Interrogez des fragments individuels par chemin ou obtenez des listes par type de modèle.
  • Filtres avancés. Affinez les résultats en appliquant des filtres sur les valeurs des champs.
  • Extraction de contenu imbriqué. Récupérez en une seule requête des fragments liés ou imbriqués (idéal pour les contenus complexes).
  • Contenu localisé et variantes. Demandez des variations spécifiques d’un fragment afin de proposer des expériences personnalisées, localisées ou sur un canal donné.
  • Requêtes dynamiques avec variables. Lors de l’exécution, injectez des valeurs (ID ou termes de recherche, par exemple) pour créer des requêtes flexibles et réutilisables sans modifier leur 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.

Bénéficiez d’une configuration sécurisée et évolutive des points d’entrée de l’API GraphQL.

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 d’entrée global. Donne accès aux modèles de fragments de contenu définis dans la configuration globale, ainsi qu’aux modèles des configurations spécifiques à chaque site. Ce point d’entrée est adapté aux structures de contenu partagées entre plusieurs projets.
  • Point d’entrée spécifique à un site. Lié à un site ou à une configuration de projet, il limite l’accès aux modèles de cette configuration et à ceux du périmètre global, assurant une isolation claire et réduisant les risques d’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é.

Accéder au point d’entrée GraphQL

Foire aux questions (FAQ)

Qu’est-ce qui différencie les API GraphQL des API REST ?
GraphQL est un langage de requête pour API qui permet d’accéder exactement aux données souhaitées via un unique point d’entrée. À l’inverse, les API REST s’appuient sur plusieurs points d’entrée et des structures de données fixes. Cela rend l’API GraphQL plus efficace, plus souple et parfaitement adaptée aux applications dynamiques et sophistiquées.

En savoir plus sur l’API GraphQL

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