API-Testfälle aus einer OpenAPI-Operation vorbereiten

Wählen Sie Operation und Ausgabeformat. Ergänzen Sie Authentifizierung, Testdaten und Vertragsprüfungen; die erzeugten Tests werden auf dieser Seite nicht ausgeführt.

Läuft lokal in deinem Browser
Dieses Werkzeug verarbeitet alle Daten lokal in deinem Browser.
OpenAPI-DefinitionFügen Sie ein OpenAPI-3.x- oder Swagger-2.0-JSON/YAML-Dokument ein. Es wird lokal analysiert; kein Server oder Endpunkt wird kontaktiert.
Erzeugte Testfälle

Wie Sie Testfälle aus einer OpenAPI-Operation ableiten

Fügen Sie ein OpenAPI-3.x- oder Swagger-2.0-Dokument ein oder öffnen Sie eine lokale .json-, .yaml- oder .yml-Datei. Pfade, Parameter, Request-Bodies und Antworten werden im Browser gelesen; die gefundenen Operationen stehen zur Auswahl.

Wählen Sie eine Operation und dann Testplan-JSON für die abzudeckenden Fälle oder Vitest + fetch für ein lauffähiges Grundgerüst, das die Anfrage aufbaut. Nichts wird hochgeladen und kein Endpunkt aufgerufen.

  1. Dokument einfügen oder Datei laden und auf API analysieren klicken. Jede Operation unter paths erscheint mit Methode, Pfad und Zusammenfassung.
  2. Operation auswählen, Testplan-JSON oder Vitest + fetch wählen und Tests erzeugen klicken. Das Ergebnis steht im unteren Feld.
  3. Mit Kopieren oder Herunterladen das Ergebnis mitnehmen; Leeren räumt Eingabe, Operationsliste und Ausgabe.
  4. Vor dem Ausführen ergänzen, was nur Sie wissen: Authentifizierung, echte Testdaten, die Basis-URL ohne Server im Dokument und die Zusicherungen, die Ihr Vertrag braucht.

Was Plan und Grundgerüst abdecken - und was Ihnen bleibt

Was das Einlesen abdeckt

Lokale Referenzen werden bis zur Definition aufgelöst: Parameter am Pfad, Request-Bodies und Schemas aus components. Pfadparameter gelten immer als erforderlich, wie es die Spezifikation verlangt - auch wenn das Dokument die Markierung vergisst.

Swagger-2.0-Dokumente werden ebenfalls gelesen. Die Basis-URL entsteht aus schemes, host und basePath, ein body-Parameter wird zum JSON-Body. Bei OpenAPI 3 wird die erste Server-URL verwendet; Servervariablen ersetzen wir durch ihre Standardwerte.

Was der erzeugte Code enthält

Die Vitest-Datei importiert describe, expect und it; legt jeden Pfadparameter als Konstante in camelCase an; baut die URL mit encodeURIComponent; setzt Query-Parameter über URLSearchParams; und sendet den JSON-Body mit passendem Content-Type-Header. Einzige Zusicherung: der Status liegt im 2xx-Bereich.

Der JSON-Plan enthält einen Erfolgsfall, je einen Fall für fehlende Pflichtangaben (Pfadparameter und Body eingeschlossen) und je einen Fall für jede dokumentierte 4xx- oder 5xx-Antwort. Beide Formate lesen das Dokument gleich, daher passen die Fallnamen zum Grundgerüst.

Wo das Werkzeug endet

Alles läuft in der Seite, die erzeugten Tests werden hier nicht ausgeführt. Ein 2xx-Status beweist nicht, dass der Antwortinhalt seinem Schema entspricht - behandeln Sie die Ausgabe als Entwurf.

Auch sehr große Dokumente werden im Browser gelesen; wird eines langsam, kürzen Sie es auf die getesteten Pfade. Für eine Prüfung der Definition selbst meldet der OpenAPI-Validator derselben Kategorie Struktur- und Referenzprobleme.

Zuletzt verwendet: