Ein Mock-Server aus Ihrer OpenAPI-Spezifikation
Zeigen Sie Mockzilla auf ein OpenAPI-Dokument und jeder Pfad darin antwortet sofort. Die Daten stammen aus Ihren eigenen Schemas und respektieren Typen, Formate, Enums und Pflichtfelder, statt überall dasselbe Platzhalterobjekt zu liefern.
- Keine Handler schreiben
- Request-Validierung
- Mehrere APIs, eine URL
- MIT-lizenzierte Engine
{
"id": "cus_9Fh2",
"email": "dana@example.com",
"currency": "eur",
"balance": 4210,
"created": 1772841600,
"delinquent": false
}Was ist ein OpenAPI-Mock-Server?
Ein Server, der ein OpenAPI-Dokument liest und jeden Pfad darin mit Daten beantwortet, die zu den Schemas passen, die Sie deklariert haben. Keine Handler, keine Fixtures und keine zweite Beschreibung der API, die zur ersten passen muss.
Mockzilla nimmt die Spezifikation als einzige Eingabe. Laden Sie sie hoch oder bauen Sie die GitHub Action in das Repository ein, in dem sie liegt, und jeder Endpunkt antwortet unter einer stabilen URL, die Ihr ganzes Team aufrufen kann.
Warten auf eine API, die Sie längst beschreiben können
Die Spezifikation steht meist lange vor der API. Bis es sie gibt, ist das Frontend blockiert, die Integrationstests haben nichts, wogegen sie laufen könnten, und alle schreiben Wegwerf-Fixtures, die sich innerhalb einer Woche vom Vertrag entfernen.
Der Mock wird aus der Spezifikation selbst gebaut, er kann also nicht auseinanderlaufen. Ändern Sie die Spezifikation, und der Mock ändert sich mit. Braucht ein Endpunkt eine exakte Antwort, schreiben Sie diesen von Hand, der Rest wird weiter erzeugt.
Aus Ihren Schemas erzeugt
Jeder Endpunkt liefert Daten, die gegen sein eigenes Response-Schema validieren: Typen, Formate, Enums, Pflichtfelder und verschachtelte Objekte.
Request-Validierung
Eingehende Requests werden gegen die Spezifikation geprüft. Ein falscher Body oder ein fehlender Parameter scheitert am Mock, statt still durchzugehen.
Mehrere APIs auf einem Server
Jede Spezifikation wird zu einem Service mit eigenem URL-Präfix, sodass Ihre API und die Fremd-APIs, von denen Sie abhängen, auf demselben Host antworten.
Fragen
- Muss ich die Antworten selbst schreiben?
- Nein. Die Spezifikation ist die Eingabe, und jeder Pfad darin antwortet, ohne dass Sie etwas schreiben.
- Kann ich einen Endpunkt mit einer festen Antwort überschreiben?
- Ja. Legen Sie eine JSON-Datei an diesem Pfad ab, und er antwortet mit genau diesem Body, während der Rest der Spezifikation weiter erzeugt wird. Das geht genauso für Pfade, die Ihre Spezifikation gar nicht beschreibt.
- Was, wenn ein Endpunkt echte Logik braucht?
- Dafür gibt es den Codegen-Modus. Mockzilla erzeugt typisierte Go-Handler aus Ihrer Spezifikation, Sie schreiben das Verhalten, das Sie brauchen, und laden den kompilierten Server hoch. Alles, was Sie nicht angefasst haben, antwortet weiter aus der Spezifikation.
- Wie verlässlich sind die erzeugten Daten?
- Die Antwortgenerierung läuft fortlaufend gegen 2.215 öffentliche OpenAPI-Dokumente mit 98.464 Endpunkten, und jeder Endpunkt muss Daten liefern, die gegen sein eigenes Schema validieren.
Spezifikation rein. Mock-Server raus.
Der Anfang kostet nichts. Dedizierte Infrastruktur, wenn Sie sie brauchen.