OpenAPI- & GraphQL-Tools
API-Vertragsarbeit ist mehr als YAML schreiben: prüfen, ob eine Schemaänderung bestehende Clients bricht, eine von einem Kollegen geteilte Postman-Collection in eine versionierbare Spezifikation verwandeln oder realistische Fixtures erzeugen, bevor ein Backend-Endpunkt überhaupt existiert. Diese Tools decken das Bearbeiten, Vergleichen und Mocken von OpenAPI und GraphQL ab, dazu einen Postman-zu-OpenAPI-Konverter und einen cURL-Befehlsgenerator zum Testen einzelner Requests.
OpenAPI-Spezifikationen vergleichen oder GraphQL-Schema-Vergleich gezielt einsetzen, um Breaking Changes zu erkennen – entfernte Felder, geänderte Typen, verschärfte Argumente – zwischen zwei Versionen vor einem Release. OpenAPI Mock-Daten generieren erzeugt Request- und Response-JSON direkt aus den Operationen, sodass ein Frontend gegen realistische Daten starten kann, bevor die echte API live ist. Alles läuft im Browser auf der eingefügten Spezifikation.
7 Tools
Alle OpenAPI / GraphQL / Postman-Tools
-
Postman zu OpenAPI
Postman zu OpenAPI mit JSON- oder YAML-Ausgabe konvertieren
-
OpenAPI-Formatter
OpenAPI 3.0 formatieren und Referenzen sowie Parameter prüfen
-
OpenAPI-Spezifikationen vergleichen
OpenAPI-Spezifikationen vergleichen und Breaking Changes erkennen
-
OpenAPI Mock-Daten generieren
OpenAPI Mock-Daten aus Schemas und Beispielen generieren
-
GraphQL-Arbeitsbereich
GraphQL-Abfragen und SDL formatieren und mit Schema prüfen
-
GraphQL-Schema-Vergleich
GraphQL-Schemas vergleichen und Breaking Changes markieren
-
cURL-Konverter
cURL-Befehle in Fetch, Axios oder Python umwandeln und literale Aufrufe zurück in curl übersetzen
FAQ zu OpenAPI / GraphQL / Postman-Tools
Beide Spec-Versionen durch OpenAPI-Spezifikationen vergleichen laufen lassen, um hinzugefügte, entfernte und geänderte Pfade, Parameter und Schemas nebeneinander zu sehen. Entfernte Felder, neu erforderliche Parameter und verengte Typen sind die Änderungen, die einen gegen die alte Spec funktionierenden Client am ehesten brechen.
Ja – Postman zu OpenAPI liest einen Postman-Collection-Export und baut ihn als OpenAPI-Dokument neu auf, inklusive der Requests, die es untersuchen kann. Das ist ein Ausgangspunkt für eine Spezifikation, die sich dann im OpenAPI-Formatter verfeinern lässt, keine vollautomatische, verlustfreie Konvertierung.
Ein REST-Diff vergleicht Pfade, Methoden, Parameter und JSON-Schemas über ein OpenAPI-Dokument hinweg. Ein GraphQL-Schema ist ein einzelner typisierter Graph, daher vergleicht GraphQL-Schema-Vergleich stattdessen Typen, Felder und Argumente direkt – das entscheidet tatsächlich, ob eine bestehende Query noch aufgelöst wird.