Geplande contentpublicatie in een headless CMS-setup

Je marketingteam wil een productaankondiging plannen voor dinsdag om acht uur 's ochtends, maar je headless CMS heeft geen ingebouwde planner. ContentGrid biedt geen planning als UI-functie, maar je kunt in ongeveer twee uur een betrouwbaar gepland publicatiesysteem bouwen met een publicatiedatumveld en een Vercel Cron-job.

Een publicatiedatumveld toevoegen

Voeg een publishAt DateTime-veld toe aan elk contenttype dat planning nodig heeft. Redacteuren stellen dit veld in als ze willen dat de entry live gaat. Voeg ook een status-veld toe met de waarden concept en gepubliceerd. De planner zet de status op gepubliceerd zodra het huidige tijdstip voorbij de publishAt-timestamp is.

• Maak publishAt optioneel — entries zonder datum worden direct gepubliceerd wanneer de status handmatig wordt ingesteld.
• Sla de timestamp in UTC op in ContentGrid. Converteer naar lokale tijd alleen in de UI.
• Voeg een publishedAt-veld toe (los van publishAt) om vast te leggen wanneer de entry daadwerkelijk live is gegaan.

De publisher API-route schrijven

Maak een API-route aan in je Next.js-app op /api/publish-scheduled. Deze route wordt aangeroepen door een cron-job:

• Authenticeer het verzoek met een geheime header om publieke toegang te voorkomen.
• Vraag ContentGrid op voor alle entries waarbij status = concept en publishAt <= nu().
• Werk voor elke overeenkomende entry de status bij naar gepubliceerd en stel publishedAt in op het huidige tijdstip.
• Trigger revalidatie voor de betrokken pagina's zodat de content direct live gaat op de site.

Gebruik de ContentGrid Management API voor de statusupdate — deze vereist een API-sleutel met schrijftoegang, die je opslaat als een server-side omgevingsvariabele.

Vercel Cron instellen

Vercel Cron voert je API-route uit volgens een schema. Voeg een vercel.json cron-configuratie toe:

• Stel het pad in op /api/publish-scheduled.
• Stel het schema in op */5 * * * * voor elke vijf minuten — voldoende granulariteit voor de meeste teams.
• Voeg het cron-geheim toe aan je Vercel-omgevingsvariabelen.
• Deploy naar Vercel en controleer of de cron-job zichtbaar is in het Vercel-dashboard onder Instellingen → Cron Jobs.

De planner testen

Test de route handmatig voordat je op het cron-schema vertrouwt:

• Maak een testentry aan met een publishAt-tijd twee minuten in het verleden.
• Roep de API-route rechtstreeks aan met de geheime header.
• Controleer of de entry-status in ContentGrid naar gepubliceerd is veranderd.
• Controleer of de pagina op je site de bijgewerkte content toont.

De cron-aanpak is eenvoudig, transparant en gratis binnen de limieten van Vercel's Hobby- en Pro-abonnement. Het voldoet aan de meeste planningsbehoeften zonder een externe dienst. Als je sub-minuutprecisie nodig hebt, schakel dan over op een Vercel Edge Function met een kortere poll-interval of gebruik een dedicated job-wachtrij zoals Inngest of Trigger.dev.