Zum Inhalt springen
EngineerBeratung
Menü
Design
Deutsch

Engineer / Beratung / Portfolio

API auf Huma v2 migriert, 100 % Übereinstimmung

Die HTTP‑API von Fiber auf Huma v2 migriert — 649 Pfade und 760 Operationen — und eine vollständige Übereinstimmung (100 %) zwischen den registrierten Serverrouten und der veröffentlichten OpenAPI‑Beschreibung erreicht und beibehalten.

Situation. Die API begann auf Fiber, mit von Hand geschriebener Anfragevalidierung für jeden Endpunkt. Für wenige Endpunkte ist das vertretbar, mit wachsender API jedoch nicht mehr. Individuelle Prüfungen erzeugen Wartungsaufwand und kleine Inkonsistenzen, weil jeder Endpunkt seine eigenen Sonderregeln hat. Eine gemeinsame Beschreibung der API‑Struktur fehlte außerdem.

Aufgabe. Die Validierung sollte aus Typen statt aus handgeschriebenen Prüfungen entstehen. Ein tatsächlicher API‑Vertrag sollte die Schnittstelle beschreiben, ohne eine große vollständige Neuentwicklung zu verlangen.

Massnahmen. Die HTTP‑Schicht wechselte auf Huma v2 über Fiber; die vorhandene Laufzeit blieb damit bestehen. Jeder Endpunkt erhält Eingabe- und Ausgabe‑Structs, aus deren Typen Huma Anfragevalidierung und Antwortmodellierung erzeugt. Die OpenAPI‑Beschreibung entsteht dabei mit, sodass die Dokumentation dem Code folgt statt in einem Wiki zu veralten. Neue Endpunkte wurden mit Huma geschrieben, bestehende Routen migriert. Genau zwei blieben direkt auf Fiber: die WebSocket‑Endpunkte, für die der direkte Socketzugriff sinnvoll ist und Humas Anfrage‑Antwort‑Modell nicht passt. Daraus sind 649 Pfade mit 760 Operationen geworden. Eine CI‑Prüfung vergleicht die tatsächlich vom Server registrierten Routen mit den in OpenAPI angekündigten. Die Übereinstimmung beträgt 100 % und bleibt bestehen, weil eine nicht beschriebene Route den Build scheitern lässt.

Ergebnis. Neue Endpunkte erhalten ohne Zusatzarbeit Validierung und aktuelle Dokumentation. Eine ganze Klasse von Fehlern nach dem Muster “hier wurde dieses Feld nicht geprüft” entfiel. Bei 760 Operationen ist die Beschreibung der einzig praktikable Einstieg in die API. Ihre garantierte Vollständigkeit zählt deshalb noch mehr als bei fünfzig. Der typisierte Vertrag machte Änderungen sicherer und die Übergabe einfacher, weil die Typen die Erwartungen eines Endpunkts beschreiben.

Kontakt

Sie klären noch, was Sie benötigen?

Erzählen Sie uns, was nicht funktioniert oder was Sie entwickeln möchten. Wir sagen Ihnen, was dafür nötig wäre, was es ungefähr kosten würde und ob wir die Richtigen dafür sind.

Ab 1.400 DKK pro Stunde, zuzüglich Mehrwertsteuer — und weniger pro Stunde bei längerer Buchung.

welcome@engineer.company +45 50 10 61 84 Kopenhagen, Dänemark