Schema-gedreven Content: Van Velddefinitie tot API-respons

Je voegt een publishedAt-datumveld toe aan je Article-type in ContentGrid. Onmiddellijk bevat je REST API-respons een publishedAt ISO 8601-string. Je GraphQL-schema krijgt een publishedAt: DateTime-veld. Je TypeScript SDK-types worden bijgewerkt met publishedAt: Date. Één beslissing, drie plaatsen automatisch bijgewerkt.

Hoe Velden API-eigenschappen Worden

ContentGrid mapt elk veldtype naar een specifiek API-uitvoerformaat. Tekstvelden geven strings terug. Getallenvelden geven integers of floats terug. Datumvelden geven ISO 8601-strings terug. Rich-text-velden geven gestructureerde JSON terug — geen HTML-strings — zodat je frontend ze kan renderen zoals het wil. Referentievelden geven standaard de ID van de gelinkte entry terug, met de optie ze uit te breiden naar inline-objecten in één query.

Deze mapping is voorspelbaar en gedocumenteerd, wat betekent dat je TypeScript-types exact overeenkomen met je API-respons. Er is geen runtime-verrassing waarbij een veld dat je als getal hebt gedefinieerd als string terugkomt omdat het CMS het anders heeft geserialiseerd.

Veldtypen en Hun API-vormen

• Korte tekst: Geeft een gewone string terug. Gebruik voor titels, slugs, labels.
• Rich text: Geeft een gestructureerd JSON-document terug met knoopsoorten zoals paragraph, heading, list. Render het met een aangepaste renderer in je Next.js-componenten.
• Referentie (enkelvoudig): Geeft een object met id en type terug, of de volledige entry wanneer uitgevouwen.
• Referentie (meervoudig): Geeft een array terug. Gebruik voor gerelateerde posts, featurelijsten of navigatie-items.
• Boolean: Geeft true of false terug. Gebruik voor feature-vlaggen zoals isFeatured of showInNav.
• JSON: Geeft ruwe JSON terug. Gebruik spaarzaam, voor data die niet past in een gestructureerd type.

Validaties als API-contracten

Validatieregels zijn niet alleen vangrails voor editors — het zijn impliciete API-contracten. Als je een veld als verplicht markeert, geeft de API nooit een entry terug waarbij dat veld null is. Als je een maximale tekenlengte instelt op een slug-veld, kun je in je frontend veilig afkaplogica toepassen wetende dat de waarde die lengte niet overschrijdt. Ontwerp validaties met de API-consument in gedachten, niet alleen de editor-ervaring.

Van Schema naar TypeScript SDK

ContentGrid's TypeScript SDK genereert interfaces automatisch vanuit je schema. Voer het typegeneratieopdracht van de SDK uit en je krijgt een Article-interface met elk veld correct getypeerd. Je Next.js getStaticProps of servercomponent kan die interface importeren en krijgt volledige autocomplete en compile-time-controle op elke API-respons. Het schema dat je in het CMS hebt ontworpen, wordt het typesysteem waarvan je frontend afhankelijk is.