Har genereret API‑kontrakten ud fra databasen
Har genereret API‑kontrakten udad fra databasen — OpenAPI, en typet
TypeScript‑klient på 44.076 linjer, 61 mock handlers og de grænser,
UI'et håndhæver — med en kontrol i hvert led, der fejler ved
afvigelser.
2025

Situation. Frontend og backend bevæger sig i deres eget tempo, og
deres antagelser om en request‑payload kan glide fra hinanden, uden
at nogen bemærker det. Som regel opdager man det ved et 422 i
browseren — når uoverensstemmelsen allerede er sendt i produktion,
hvilket er det dyreste tidspunkt at finde ud af det på. At skrive de
to sider i hånden ud fra det samme dokument løser ikke problemet;
det flytter bare afvigelsen over på den, der glemte at læse
dokumentet igen.

Opgave. De to sider skulle genereres fra én kilde i stedet for at
blive aftalt mellem to, og hvert trin i genereringen skulle
kontrolleres i stedet for at blive taget for givet.

Handling. Kæden starter ved databasen og løber udad. Skemaet og dets
funktioner definerer datastrukturerne; Go‑typerne definerer API'et;
Huma genererer OpenAPI‑beskrivelsen ud fra dem; en typet
TypeScript‑klient på 44.076 linjer genereres ud fra den beskrivelse;
61 mock‑handlere genereres sammen med den, så frontendens egne tests
kører mod den rigtige kontrakt i stedet for mod en håndskrevet
fixture; og de grænser, brugerfladen håndhæver i en formular, kommer
fra samme sted i stedet for at blive tastet ind i en validator igen.
Hvert led har sin kontrol. Et kontrakttjek i CI sammenligner det,
frontenden sender, med det, API'et forventer, og får buildet til at
fejle ved afvigelser, og under det ligger en skemaprobe, der tjekker
de faktiske strukturer og ikke en beskrivelse af dem. Kontrollen
dækker bevidst de steder, hvor afvigelser gerne gemmer sig: valgfrie
body‑felter, hvor "mangler" og "null" bliver forvekslet, og
query‑parameter‑enums, hvor de to sider i al stilhed kan være uenige
om de tilladte værdier.

Resultat. Et felt kan ikke ændre sig på kun den ene side — ændringen
fejler ved det første led, der opdager den, i et build, minutter
efter ændringen. Det fjernede en tilbagevendende og virkelig
irriterende fejlkategori, den slags, der er usynlig i code review og
først viser sig i runtime. Prisen er et genereringstrin midt i det
hele: at regenerere er en sur pligt, og kæden er kun så troværdig
som sit dårligst bevogtede led, hvilket er grunden til, at hvert led
fik sin kontrol.

Kategorier:
1Backend‑udvikling	/da/categories/backend/	platform.engineer.company	70
1API'er & integration	/da/categories/api/	platform.engineer.company	70
1DevOps	/da/categories/devops/	platform.engineer.company	70
1Automatisering & CI/CD	/da/categories/automation/	platform.engineer.company	70
1Driftssikkerhed & backup	/da/categories/reliability/	platform.engineer.company	70
1Test & QA	/da/categories/testing/	platform.engineer.company	70

Ydelser:
1Backend- & API‑udvikling	/da/services/backend-development/	platform.engineer.company	70
1Værktøjer til AI‑agenter & MCP‑servere	/da/services/ai-tools/	platform.engineer.company	70
1DevOps & CI/CD‑automatisering	/da/services/devops-cicd/	platform.engineer.company	70

hDenne side på nettet	URL:https://platform.engineer.company/da/portfolio/generated-the-api-contract-from-the-database-out/	platform.engineer.company	70
