OpenAPI-/Swagger-Betrachter

Rendern Sie ein OpenAPI-3.0 / 3.1- oder Swagger-2.0-Dokument (YAML oder JSON) zu einer durchsuchbaren API-Referenz — Info, Server, nach Tags gruppierte Pfade, Parameter, aus Schemas erzeugte Beispiele für Request-Bodies, Antworten und Sicherheit. Klappen Sie jede Operation auf, um Ausprobieren zu nutzen und eine Live-Anfrage aus Ihrem Browser zu senden, oder exportieren Sie sie als cURL. Dokumente werden lokal geparst; entfernte $ref-Ziele und externe Schemas werden nicht abgerufen (vollständig lokal). Lieber einen interaktiven Anfrage-Composer? Siehe den REST-API-Client / -Tester und die ganze Familie API-Werkzeuge.
OpenAPI- / Swagger-Dokument
Ausprobieren
Parameter
Zu diesem Betrachter: unterstützt Swagger 2.0 sowie OpenAPI 3.0 / 3.1. Referenzen werden nur innerhalb des Dokuments aufgelöst (#/components/schemas/…, #/definitions/…); externe Datei- oder URL-Referenzen werden gemeldet, aber nicht abgerufen. Ausprobieren-Aufrufe unterliegen der CORS-Richtlinie des Zielservers — wird ein Aufruf blockiert, verwenden Sie den cURL-Konverter oder den REST-Client, um ihn außerhalb der Browser-Sandbox auszuführen.
OpenAPI gegen Swagger, v2 gegen v3

Swagger war der ursprüngliche Name der Werkzeuge; als das Spezifikationsformat 2015 an die Linux Foundation übergeben wurde, wurde daraus OpenAPI, und Swagger lebt als Marke für Werkzeuge weiter. Ein Dokument besteht aus info (Metadaten), paths (Operationen je Endpunkt) und components (wiederverwendbare Schemas).

Der Versionsschlüssel sagt dem Betrachter, welchen Parser er verwenden soll: swagger: "2.0" gegenüber openapi: 3.0.x — v3 hat Request-Bodies aus den Parametern herausgelöst und echtes JSON Schema übernommen.