Bevægelsen: To oprydninger med næsten samme deadline
Foto: Thought Catalog på Unsplash
Contentful har i to separate changelog-opslag annonceret API-ændringer, der lander 13 dage fra hinanden i februar 2027.
I det første deprecates to legacy-endpoints til forbrugsrapportering i Content Management API (organization_periodic_usages og space_periodic_usages) pr. 18. August 2026 og fjernes helt 28. Februar 2027, hvor kaldene returnerer 410 Gone. Erstatningen er en samlet Usage API med daglig og månedlig granularitet, valgfri datoperioder og alle forbrugsmetrics samlet på én overflade: API-kald, asset bandwidth, AI actions og Functions. Det er samme API, der driver forbrugs-dashboardet i Contentfuls webapp.
I det andet skifter endpointet for listning af space-roles pr. 15. Februar 2027 fra offset-baseret paginering (skip/total) til cursor-baseret navigation (pageNext/pagePrev). Integrationer, der parser den gamle svarstruktur, går i stykker på rollout-tidspunktet.
Min læsning: To teknisk uafhængige ændringer med næsten identiske deadlines ligner et koordineret oprydningsprogram. Contentful betaler af på arkitektonisk gæld og sender regningen videre til kunderne som migreringsarbejde. Det er legitimt – cursor-paginering er branchestandard, og den nye Usage API er objektivt bedre end de gamle endpoints. Men arbejdet lander hos dig.
Hvorfor det interesserer os: Den stilfærdige fejl i integrationer uden ejer
Indholdet i ændringerne er banalt. Forbrugsrapportering og roles-listing er ikke kampagnekritisk funktionalitet. Men netop derfor er de farlige: Den slags endpoints bor i integrationer uden dagligt ejerskab – scriptet, der afstemmer Contentful-fakturaer en gang om måneden, provisioning-automatiseringen en konsulent skrev i 2023, forbrugstallene embedded i jeres BI-dashboard.
Og fejlen kommer stilfærdigt. Et 410 Gone sprænger ikke noget. Det giver tomme lister og null-værdier, dashboards der viser nul. Det opdages først, når en faktura ikke kan afstemmes eller en rolletildeling fejler – sandsynligvis i Q1 2027, mens regnskabet lukkes.
Kanalen forstærker problemet. Deprecation annonceres i en developer-changelog via RSS. Dine udviklere ser den måske. Du gør ikke. Konsekvensen er økonomisk og organisatorisk, kommunikationen er teknisk.
Det bredere mønster: Som vi skrev i Headless CMS som infrastruktur, er CMS-stakken blevet infrastruktur – og infrastruktur har livscyklus. Alle SaaS-leverandører moderniserer løbende deres API-overflade, og hver modernisering er en mikro-migrering, kunden betaler. Contentful er faktisk pæn her: lidt over seks måneders varsel og en migrationsguide med parameter-mapping. Pointen er ikke Contentful. Pointen er, at API-lifecycle er en løbende, men ukendt post i dit budget hos enhver leverandør.
Læringen for dig: Fem ting du kan gøre nu
- Byg et afhængighedstæppe. Hvilke integrationer og scripts kalder hvilke endpoints i jeres CMS-stak – inklusive dem, bureauer og systemintegratorer har bygget? Kræv endpoint-dokumentation i kontrakten ved næste fornyelse.
- Fastlæg ejerskab. Usage-endpoints rammer typisk FinOps-automatisering snarere end kampagnearbejde. Hvis hverken marketing ops, IT eller økonomi ejer migreringen, sker den ikke.
- Budgettér i 2026, eksekér i 2026. To endpoints er måske to til fem dages udviklerarbejde. Den dyre del er at finde alle kaldstederne. Brandmandsarbejde efter 28. Februar koster et multiplum.
- Vend byrden til forbrugsovervågning. Den nye Usage API giver self-serve-data med daglig granularitet og per-asset bandwidth-nedbrydning – stærkere FinOps end de gamle endpoints nogensinde leverede. Med AI actions og Functions som fakturerbare metrics er ordentlig forbrugsregistrering snart ikke valgfrit.
- Spørg alle leverandører om deres deprecation-politik. Minimumsvarsel, migrationsstøtte, versionering. Læg svaret ind i vendor-risikovurderingen ved næste indkøb – det siger mere om dine fremtidige omkostninger end enhver feature-liste.
Den næste pensionering kommer, fra Contentful eller en anden. Med et afhængighedstæppe er det en tirsdagsopgave. Uden er det en krise, I opdager, når tallene går stille i februar 2027.
Ét svar til “Contentful sender API-endpoints på pension – skjult gæld der forfalder i februar 2027”
[…] kender du fra den anden ende. Da Contentful sendte API-endpoints på pension med deadline i februar 2027, var ændringen ubehagelig, men den bliver opdaget, fordi integrationerne fejler højt. Den her […]