Zum Inhalt springen

Code generieren und eine API-Spezifikation exportieren

Mitgeschnittene Requests sind nicht nur zum Ansehen da, sie können direkt zum Ergebnis werden: Aus einem Request wird mit einem einzigen Klick lauffähiger Code (5 Sprachen), eine ganze Sitzung wird zu einer sauberen API-Spezifikation (OpenAPI) zusammengeführt, oder sie wird in das universelle Austauschformat HAR exportiert. Alles stammt direkt aus echten Mitschnitten: kein Abschreiben von Hand, kein Schreiben von Grund auf. Auch anderswo mitgeschnittene Sitzungen lassen sich hier importieren und analysieren.


1. Code generieren: aus einem Request wird lauffähiger Code

Abschnitt betitelt „1. Code generieren: aus einem Request wird lauffähiger Code“

Einen Request mitgeschnitten, den du reproduzieren oder teilen möchtest? Verwandle ihn mit einem Klick in fertig lauffähigen Code, füge ihn dann in ein Terminal ein, lege ihn in einem Projekt ab oder schicke ihn einem Kollegen.

5 Formen, wechsle die Sprache, um sofort neu zu generieren, kopiere mit einem Klick:

  • cURL (in ein Terminal einfügen, und es läuft)
  • Python
  • JavaScript
  • Go
  • OkHttp (Java / Kotlin)

Der generierte Code ist vollständig: Request-Methode, URL, alle Header und der Body. Die Header behalten ihre ursprüngliche Reihenfolge und etwaige Duplikate, Reihenfolge und wiederholte Einträge bleiben exakt erhalten, sodass das, was läuft, dem echten Request originalgetreu entspricht und sofort einsatzbereit ist.

Code generieren: zwischen cURL / Python / JavaScript / Go / OkHttp wechseln, vollständig mit Methode, Headern und Body, Kopieren mit einem Klick

Gewöhnliche Tools ordnen die Header oft um und deduplizieren sie beim Generieren von Code, sodass die Reproduktion vom Original abweicht; hier bleiben sie exakt erhalten, sodass das, was läuft, dem echten Request entspricht.

Woher generieren

  • Mitschnittliste: Rechtsklick auf einen beliebigen Request, dann „Code generieren …“.
  • Composer: nachdem du einen Request unter Zusammenstellen und Wiederholen angepasst hast, klicke auf „Code generieren“.

Wann verwenden: einen echten mitgeschnittenen Request in ein Skript oder Projekt reproduzieren; einen Request als Code exportieren, nachdem er im Composer läuft, und dann weiterentwickeln; einen einzelnen Request mit einem Kollegen teilen (jeder kann eine cURL-Zeile ausführen).


2. Eine API-Spezifikation exportieren: aus einer Sitzung wird OpenAPI

Abschnitt betitelt „2. Eine API-Spezifikation exportieren: aus einer Sitzung wird OpenAPI“

Eine Strecke API-Verkehr mitgeschnitten und eine ordentliche Spezifikation gewünscht? Die App ordnet diese Requests automatisch, führt sie zu einer Endpunktliste zusammen und erzeugt mit einem Klick ein OpenAPI-Dokument, ganz ohne Schreiben von Hand.

  • Erst analysieren, dann exportieren: Die App erkennt Endpunkte automatisch aus der aktuellen Sitzung und listet sie zur Kontrolle auf, sodass du nur exportierst, was du auswählst, und Rauschen vermeidest. Die Liste zeigt zu jedem Endpunkt direkt die Methode, den Pfad, die Anzahl der Vorkommen und die beobachteten Statuscodes und gibt dir so auf einen Blick ein klares Bild.
  • Pfade automatisch zusammenführen: Die App templatisiert Pfade mit konkreten IDs, aus /users/123 wird zum Beispiel /users/{id}, und führt mehrere Requests an denselben Endpunkt zu einem zusammen.
  • Struktur automatisch ableiten: Die App führt die JSON-Struktur von Requests / Responses zusammen, gruppiert Responses nach Statuscode und organisiert Pfadvariablen zu Parametern.
  • Erzeugt standardkonformes OpenAPI 3.0: kopiere oder lade es herunter, importiere es dann in ein beliebiges OpenAPI-kompatibles Tool und arbeite weiter.

OpenAPI exportieren: links Endpunkte prüfen (Methode / Pfad / Anzahl der Vorkommen / Statuscodes), rechts eine Live-Vorschau der automatisch abgeleiteten OpenAPI-3.0-Spezifikation

Wann verwenden: nach dem Mitschneiden von API-Verkehr schnell eine ergebnisreife, importierbare OpenAPI-Spezifikation erzeugen; Analysearbeit, Integration mit APIs Dritter, Dokumentation für das Backend-Team ergänzen oder Testfälle für die QA aufbauen.


3. Import und Export: mit anderen Tools zusammenarbeiten

Abschnitt betitelt „3. Import und Export: mit anderen Tools zusammenarbeiten“

Mitgeschnittener Verkehr ist nicht eingesperrt, und anderswo mitgeschnittener Verkehr lässt sich hereinholen. Ein einziges Standard-Austauschformat für Sitzungen schlägt die Brücke in beide Richtungen:

  • HAR exportieren: exportiere einen ganzen Mitschnitt mit einem Klick in eine standardkonforme HAR-1.2-Datei, zur Übergabe, Archivierung oder Weitergabe an ein anderes Tool für die weitere Analyse.
  • Von anderen mitgeschnittene Sitzungen importieren: importiere externe Sitzungsdateien (HAR 1.2, .pcap / .pcapng sowie von gängigen Mitschnitt-Tools exportierte Sitzungsdateien), sodass von jemand anderem mitgeschnittene Pakete hereingeholt, angesehen, verglichen und exportiert werden können.

Wann verwenden: Verkehr hereinholen, der in der Produktion, von einem Kollegen oder von anderen Tools mitgeschnitten wurde, und ihn hier mit den Decodern, Host-Profilen und dem Request-Vergleich weiter analysieren; oder eine Strecke des hier mitgeschnittenen Verkehrs in ein universelles Format exportieren, um sie zu übergeben.


Zurück zu Proxy-Mitschnitt · Verwandt: Zusammenstellen und Wiederholen · Untersuchen und Decodieren