# OpenAPI-Validator

Prüfe ein OpenAPI-3.0-, 3.1- oder 3.2- oder Swagger-2.0-Dokument in YAML oder JSON und erhalte eine Übersicht seiner Endpunkte und Schemas. Der Validator prüft erforderliche Felder, Pfadvorlagen anhand der Pfadparameter, Parameterpositionen, Antwortcodes, doppelte Operation-IDs und jede lokale $ref und listet jedes Problem mit seiner Position auf.

## Häufig gestellte Fragen

### Was prüft der Prüfer?

Er prüft die OpenAPI- oder Swagger-Version, info.title und info.version, ob Pfade mit einem Schrägstrich beginnen, ob jeder {parameter} in einem Pfad einem passenden erforderlichen Pfadparameter entspricht und umgekehrt, sowie Parameternamen und -positionen, Antwortstatuscodes und -beschreibungen, doppelte Parameter, doppelte operationId-Werte und ob jede lokale $ref auf etwas im Dokument verweist.

### Ist das eine vollständige Validierung der Spezifikation anhand des JSON-Schemas?

Nein. Es prüft die oben genannten Strukturregeln, die die meisten Fehler in manuell geschriebenen Dokumenten erkennen. Es validiert jedoch nicht jedes Feld anhand des offiziellen Metaschemas und prüft auch nicht den Inhalt deiner Schemas.

### Was zeigt die Übersicht?

Die Spezifikation und API-Version, den Titel, eine Tabelle mit allen Endpunkten samt Methode, Pfad, operationId, Zusammenfassung und Antwortcodes sowie die Namen der Schemas unter components.schemas oder, bei Swagger 2.0, unter definitions.

### Werden externe Referenzen verfolgt?

Nein. Referenzen auf andere Dateien oder URLs werden weder abgerufen noch gemeldet. Nur Referenzen, die mit # beginnen, werden innerhalb des eingefügten Dokuments aufgelöst.

### Was ist der Unterschied zwischen Fehlern und Warnungen?

Fehler verstoßen gegen eine Spezifikationsregel, etwa eine fehlende Antwortbeschreibung oder einen nicht deklarierten Pfadparameter. Warnungen weisen auf zulässige, aber meist unbeabsichtigte Dinge hin, etwa eine GET-Operation mit Request-Body oder ein Dokument ohne operationId.

### Ändert OpenAPI 3.1, was erforderlich ist?

Ja. In OpenAPI 3.1 und 3.2 benötigt eine Operation kein responses-Objekt mehr, und ein Dokument kann Webhooks oder components statt paths enthalten. Der Validator wendet diese Regeln an, wenn das openapi-Feld mit 3.1 oder 3.2 beginnt.

Deine Anzeige hier?

[Schreib uns eine E-Mail](mailto:hi@dennn.is?subject=Werbung%20auf%20OneClick%20Pro)

[Anzeige 433 Tools für deine KI-Agenten über einen MCP-Server.](https://multitaskai.com/de/?ref=oneclickpro)
