Det der skete
Foto: alleksana på Pexels
Contentful har annonceret en ændring i GraphQL Content API, der er let at overse og endnu lettere at undervurdere. Ved cursor-baseret pagination på reference-felter, altså queries som authorsCursorCollection, har standardrækkefølgen hidtil været »sidst opdateret først«. Det ændres nu: Resultatet vil i stedet spejle rækkefølgen af referencerne, præcis som de er arrangeret i entry-editoren. Har en redaktør sat to forfattere i rækkefølgen A, B, kommer de ud i den orden, og flyttes B op foran A i editoren, ændres API-svaret tilsvarende. Det fremgår af Contentfuls changelog.
Ændringen gælder kun GraphQL Content API og kun cursor-baseret pagination på reference-felter. To detaljer gør den alligevel karakteristisk: Alle queries forbliver gyldige, så intet slår fejl, og ingen monitorering lyser rødt. Og changeloggen oplyser ingen ikrafttrædelsesdato. En adfærdsændring i produktionssystemet, uden deadline og uden fejlmeddelelse.
Hvad det betyder for dig
Reference-felter lyder tekniske, men de tegner ting, dine kunder ser: relaterede produkter under en vare, forfatterlisten under en artikel, modulrækkefølgen på en landingsside. Når standarden skifter fra tidsstempel til redaktionel rækkefølge, kan brugeroplevelsen ændre sig på sider, hvor ingen har rørt koden. Rækkefølgen af relaterede produkter er merchandising, og rækkefølgen af moduler er implicit prioritering af dine budskaber. Det er ikke en teknisk detalje, det er en kommerciel parameter, der flyttes.
Mønsteret 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 fejler lavt: svaret er stadig gyldigt, dashboardet er grønt, kun rækkefølgen er en anden. Tommelfingerreglen er, at API-ændringer med fejlmeddelelser bliver fanget af jeres monitorering, mens ændringer i gyldige svar bliver fanget af jeres kunder.
Der er dog en reel opsiden, hvis den bruges bevidst. Magtskiftet flytter kontrollen med rækkefølgen fra udviklernes queries til redaktørerne i CMS’et, og en kampagnejustering, der før krævede en udvikler-ticket, kan nu klares ved at trække i rækkefølgen i editoren. Men gevinsten forudsætter governance: Hvis ingen aktivt kuraterer, bliver standarden »den rækkefølge, referencerne tilføjet i«, og det kan være værre end »nyeste først« på friskhedsdrevne flader som nyhedsmoduler og kampagnelister. Den næste konsekvens kommer hurtigt bagefter: redaktionel QA bliver reelt en release-aktivitet, hvor rækkefølgen gennemsynes med samme alvor som design og layout før udrulning.
Det konkrete næste skridt er at bede teamet eller bureauet auditere jeres GraphQL-queries for cursorCollection på reference-felter i denne uge. Afgør pr. Brugsscenarie, om redaktionel rækkefølge eller recency er den rigtige, og sæt eksplicit sortering i queryen dér, hvor »nyeste først« skal bestå. Det lyder som en opgave til udviklerne, men ejerskabet er dit: Rækkefølgen af dit indhold er en del af brandoplevelsen, og fra nu af er den redaktionel som standard. Spørgsmålet til jeres næste møde er derfor ikke, om queriesne virker, men hvad de reelt viser først.