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
identypeterug, of de volledige entry wanneer uitgevouwen. - Referentie (meervoudig): Geeft een array terug. Gebruik voor gerelateerde posts, featurelijsten of navigatie-items.
- Boolean: Geeft
trueoffalseterug. Gebruik voor feature-vlaggen zoalsisFeaturedofshowInNav. - 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.
Klaar om je concurrenten te volgen?
ContentGrid monitort automatisch websites, e-mails en social media van je concurrenten — en levert gestructureerde intelligence rechtstreeks in je inbox.