Lever gestructureerde content op grote schaal met de GraphQL API.

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 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-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.

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.