#F5F5F5

Lever gestructureerde content op grote schaal met de GraphQL API.

#F5F5F5

Versnel de omnichannel levering van content met de GraphQL API en Adobe Experience Manager Sites.

Adobe Experience Manager Sites biedt ontwikkelaars native integratie van de GraphQL API om de levering van gestructureerde content aan webpagina's, apps en andere digitale kanalen te stroomlijnen. Hierdoor kunnen teams contentactiviteiten opschalen terwijl ze voldoen aan de groeiende vraag naar dynamische, gepersonaliseerde ervaringen.

De GraphQL API stroomlijnt de levering van content.

Oudere REST API's belasten applicaties vaak met meerdere serveraanroepen of buitensporige datapayloads, wat de prestaties ondermijnt en de ontwikkeling bemoeilijkt. Experience Manager Sites verhelpt dit met een native GraphQL API, waarmee front-endteams exact de juiste content kunnen opzoeken met één efficiënte aanvraag.

Als voorkeurs-CMS voor ondernemingen combineert Experience Manager Sites beheer van gestructureerde content met moderne leveringsopties. Dankzij de GraphQL-integratie zijn er geen inflexibele eindpuntstructuren, wat schaalbare, krachtige levering van content aan websites, apps en digitale ervaringen mogelijk maakt.

Experience Manager Sites GraphQL API is ontworpen voor hedendaagse samengestelde architecturen en biedt korte paginalaadtijden, agile ontwikkeling en de flexibiliteit die ondernemingen nodig hebben om te voldoen aan de veranderende eisen van de klant – op grote schaal en nauwkeurig.

De GraphQL API-integratie verbetert contentcreatie.

De GraphQL API in Experience Manager is ontworpen om gestructureerde content te tonen – met name contentfragmenten – voor headless levering via elk digitaal kanaal. De API fungeert als één, flexibel eindpunt, waarmee clientapplicaties exact kunnen ophalen wat ze nodig hebben, wanneer ze het nodig hebben.

Deze moderne, op grafieken gebaseerde aanpak biedt duidelijke voordelen tegenover oudere REST-methoden:

  • Efficiëntie. Haal complexe, geneste contentstructuren op met één API-aanroep – geen koppeling van meerdere eindpunten. Dit vereenvoudigt de ontwikkeling en verkort de paginalaadtijden.
  • Precisie. Ontwikkelaars zoeken alleen de vereiste velden op, wat resulteert in kleinere payloads en betere prestaties, met name op mobiele netwerken.
  • Flexibiliteit. De GraphQL API is onafhankelijk van de front-end, zodat teams kunnen ontwikkelen met elk framework – React, Angular, Vue en meer – zonder gebonden te zijn aan bedrijfseigen SDK's.

GraphQL API versus traditionele REST API.

Kenmerk

Experience Manager GraphQL API

Traditionele REST API

Eindpuntstructuur
Doorgaans één samengevoegd GraphQL-eindpunt per configuratie.
Meerdere eindpunten per resource of gebruiksscenario.
Data ophalen
De client geeft exact aan welke velden vereist zijn in de query.
De server definieert de vaste datastructuur per eindpunt.
Te veel of te weinig ophalen
Wordt voorkomen, de exacte data wordt geretourneerd.
Gangbaar probleem: er kan te veel of te weinig data worden opgehaald.
Aanvraagvolume
Haalt gerelateerde data (geneste fragmenten) op in één aanvraag.
Vereist vaak meerdere aanvragen voor gerelateerde data.
Caching (standaardaanvraag)
POST-aanvragen worden doorgaans niet gecachet door tussenschakels.
GET-aanvragen worden eenvoudig gecachet.
Caching (Experience Manager-benadering)
Met persistente query's kunnen GET-aanvragen worden gecachet.
GET-aanvragen worden eenvoudig gecachet.
API-ontwikkeling
Schema kan veranderen; eenvoudig om 'non-breaking' velden toe te voegen.
Het toevoegen van velden kan problemen opleveren; vaak is versiebeheer nodig.

Belangrijkste mogelijkheden van GraphQL in Experience Manager Sites.

De GraphQL API-integratie met Experience Manager Sites biedt diverse belangrijke mogelijkheden:

GraphQL-schema genereren.

Experience Manager Sites vereenvoudigt headless ontwikkeling door automatisch GraphQL-schema's te genereren voor je contentfragmentmodellen – het is niet nodig om handmatig schema's te maken. Wanneer contentarchitecten modellen definiëren of bijwerken, zet Experience Manager deze direct om in een live, volledig getypeerd GraphQL-schema op het bijbehorende eindpunt.

Dit dynamisch gegenereerde schema biedt diverse voordelen op ondernemingsniveau:

  • Goede typering en vroegtijdige validatie. Typering op basis van een schema biedt voorspelbare resultaten en detecteert ongeldige query's voordat deze worden uitgevoerd. Dit bespaart tijd en vermindert fouten tijdens de ontwikkeling.
  • Ingebouwde introspectie. Ontwikkelaars kunnen query's uitvoeren op het schema zelf, waarbij functies beschikbaar komen zoals automatisch aanvullen, validatie en in-line documentatie met GraphQL-tools.
  • Contentgestuurde consistentie. Het schema toont de werkelijke contentstructuur en fungeert als één bron van waarheid. Deze strakke afstemming van auteurs op ontwikkelaars stroomlijnt de samenwerking en voorkomt afwijkingen ten opzichte van het schema.

Door automatisch schema's te genereren maakt Experience Manager Sites snellere headless builds mogelijk, terwijl de onderhoudsoverhead wordt verminderd en de kloof tussen gestructureerde content en schaalbare levering wordt overbrugd.

Zoek exact wat je nodig hebt op met GraphQL.

GraphQL biedt clientapplicaties volledige controle over de structuur en het specifieke karakter van de contentaanvragen. In Experience Manager Sites kunnen ontwikkelaars met GraphQL-query's op efficiënte wijze gestructureerde content ophalen uit contentfragmenten – die zijn toegesneden op de vereisten van hun applicatie. De belangrijkste mogelijkheden zijn:

  • Veldselectie. Haal alleen de velden op die je nodig hebt – niets meer, zodat payloads worden geminimaliseerd en de prestaties stijgen.
  • Gerichte toegang tot fragmenten. Zoek individuele contentfragmenten per pad of haal lijsten op per modeltype.
  • Geavanceerde filtering. Verfijn de resultaten door filters toe te passen op veldwaarden.
  • Geneste content ophalen. Haal geneste of gekoppelde contentfragmenten op in één query – ideaal voor complexe contentrelaties.
  • Gelokaliseerde content en varianten. Vraag specifieke variaties van een fragment aan om gepersonaliseerde, regionale of kanaalspecifieke ervaringen te leveren.
  • Dynamische query's met variabelen. Injecteer waarden zoals ID's of zoektermen tijdens runtime om flexibele, herbruikbare query's te maken zonder de structuur te herschrijven.

GraphQL in Sites biedt ontwikkelaars een krachtige, intuïtieve interface om toegang te krijgen tot headless content – ontworpen voor snelheid, schaalbaarheid en precisie.

Veilige en schaalbare configuratie van GraphQL-eindpunten.

In Experience Manager Sites worden GraphQL-query's verzonden naar opgegeven eindpunten – specifieke URL's die fungeren als toegangspunten voor de levering van headless content. In tegenstelling tot REST API's met meerdere eindpunten voor verschillende resources, centraliseert GraphQL interacties via één eindpunt per configuratie, wat de ontwikkeling vereenvoudigt en de beheerbaarheid verbetert.

Met het oog op goede governance moeten GraphQL-eindpunten in Sites expliciet worden geconfigureerd, geactiveerd en gepubliceerd door een beheerder. Dit verbetert de beveiliging en controle voordat gestructureerde content wordt getoond. Sites ondersteunt twee typen GraphQL-eindpunten:

  • Algemeen eindpunt. Biedt toegang tot contentfragmentmodellen die zijn gedefinieerd in de algemene configuratie, in combinatie met modellen van sitespecifieke configuraties. Ideaal voor gedeelde contentstructuren die worden hergebruikt tussen projecten.
  • Sitespecifiek eindpunt. Dit eindpunt is gekoppeld aan een bepaalde site- of projectconfiguratie en biedt alleen toegang tot modellen van deze configuratie plus de algemene – zodat projecten worden geïsoleerd en van elkaar worden afgeschermd.

Deze flexibele aanpak stelt ondernemingen in staat om de levering van content voor allerlei merken, regio's of businessunits nauwkeurig te beheren – wat resulteert in schaalbaarheid zonder afbreuk te doen aan de beveiliging of duidelijkheid.

Naar GraphQL-eindpunt navigeren

Veelgestelde vragen

Wat is het verschil tussen GraphQL API's en REST API's?
GraphQL is een moderne querytaal voor API's waarmee clients exact de data die ze nodig hebben kunnen aanvragen van één eindpunt, in tegenstelling tot REST API's die werken met meerdere eindpunten en vaste datastructuren. Dit maakt GraphQL efficiënter, flexibeler en ideaal voor dynamische applicaties die rijk aan content zijn.

Meer informatie over GraphQL API.

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