Migrerade API:t till Huma v2 med 100 % paritet
Migrerade HTTP‑API:t från Fiber till Huma v2 — 649 sökvägar och 760
operationer — och nådde och behöll 100 % paritet mellan de rutter
som servern registrerar och den OpenAPI‑beskrivning den publicerar.
2025

Situation. API:et började sitt liv på Fiber, med validering av anrop
som skrevs för hand, slutpunkt för slutpunkt. Det fungerar när det
finns en handfull slutpunkter. Det slutar fungera när ytan växer:
den handskrivna valideringen blir en ständig underhållsbörda, och
små inkonsekvenser smyger sig in eftersom varje slutpunkts
kontroller är ett eget litet specialfall. Och det fanns ingenstans
en samlad beskrivning av hur API:et såg ut.

Uppgift. Målet var validering som följde av typerna i stället för av
handskrivna kontroller, och ett verkligt kontrakt som beskrev API:et
— utan att stanna upp för en omskrivning av allt i ett enda svep.

Handling. HTTP‑lagret flyttades till Huma v2, som ligger ovanpå
Fiber, så den befintliga körmiljön fick vara kvar. Varje slutpunkt
får structar för indata och utdata, och Huma genererar valideringen
av anropen och modelleringen av svaren utifrån de typerna. En
OpenAPI‑beskrivning kommer på köpet, vilket betyder att
dokumentationen håller jämna steg med koden i stället för att ruttna
i en wiki. Allt nytt skrevs mot Huma och de befintliga rutterna
migrerades över, med exakt två slutpunkter kvar på ren Fiber — de
för WebSocket, där du verkligen vill åt själva socketen och Humas
modell med anrop och svar inte passar. Det har vuxit till 649
sökvägar med 760 operationer, och en kontroll i CI som jämför de
rutter som servern faktiskt registrerar med dem som
OpenAPI‑beskrivningen utlovar. Överensstämmelsen är 100 %, och den
ligger kvar där eftersom en rutt som saknar beskrivning stoppar
bygget.

Resultat. Nya slutpunkter får validering och aktuell dokumentation
utan att någon behöver lägga extra arbete på det, och en hel klass
av buggar i anropshanteringen — av typen ”oj, vi glömde kontrollera
det fältet här” — försvann. Med 760 operationer är beskrivningen det
enda praktiska sättet för någon att läsa API:et, så garantin att den
är komplett väger tyngre än den gjorde vid femtio. Det typade
kontraktet gjorde API:et både säkrare att ändra och lättare att
lämna över till någon annan, eftersom typerna talar om vad en
slutpunkt förväntar sig.

Kategorier:
1Plattformsarkitektur	/sv/categories/platform-architecture/	software.engineer.company	70
1Backendutveckling	/sv/categories/backend/	software.engineer.company	70
1API:er och integration	/sv/categories/api/	software.engineer.company	70
1Migrering och modernisering	/sv/categories/migration/	software.engineer.company	70
1Test och kvalitetssäkring	/sv/categories/testing/	software.engineer.company	70
1Dokumentation	/sv/categories/documentation/	software.engineer.company	70

Tjänster:
1Plattforms- och lösningsarkitektur	/sv/services/platform-architecture/	software.engineer.company	70
1Backend- och API‑utveckling	/sv/services/backend-development/	software.engineer.company	70
1Verktyg för AI‑agenter och MCP‑servrar	/sv/services/ai-tools/	software.engineer.company	70
1Teknisk dokumentation	/sv/services/technical-documentation/	software.engineer.company	70

hDen här sidan på webben	URL:https://software.engineer.company/sv/portfolio/migrated-the-api-to-huma-v2-at-100-parity/	software.engineer.company	70
