Entwicklung

YAML Viewer & API-Tester

Öffne YAML-Dateien wie docker-compose.yml, GitHub-Workflows oder Kubernetes-Manifeste, finde Fehler mit Zeile und Erklärung und wandle sie in JSON um. Enthält die Datei eine OpenAPI- oder Swagger-Beschreibung, kannst du die Endpunkte direkt testen.

  • Läuft komplett in deinem Browser
  • Keine Datenübertragung
  • Ohne Anmeldung
  • Kostenlos
Beispiel:

YAML

Ansicht

$

Anleitung

So funktioniert’s

  1. YAML laden

    Füge YAML (oder JSON) ins linke Feld ein, ziehe eine .yaml- bzw. .yml-Datei hinein oder öffne sie über „Datei öffnen“. Zum Ausprobieren gibt es drei Beispiele.

  2. Fehler finden

    Das Tool prüft sofort. Bei einem Fehler siehst du Zeile, Spalte und eine Erklärung auf Deutsch – etwa zu Tabulatoren, falscher Einrückung oder fehlendem Doppelpunkt. Hinweise zeigen typische Fallen wie „no“ oder „22:22“.

  3. Ansehen und umwandeln

    In der Baumansicht klappst du die Struktur auf und kopierst den Pfad zu jedem Wert. Unter „YAML“ steht die Datei einheitlich formatiert, unter „JSON“ als JSON – zum Kopieren oder Herunterladen.

  4. API testen

    Ist die Datei eine OpenAPI- oder Swagger-Beschreibung, erscheint darunter der API-Tester: Endpunkt wählen, Parameter und Body ausfüllen, „Anfrage senden“ – und Status, Antwortzeit, Header und Antwort ansehen. Den passenden curl-Befehl gibt es dazu.

FAQ

Häufige Fragen

Werden meine Dateien hochgeladen?

Nein. Die YAML-Datei wird nur in deinem Browser gelesen. Auch Testanfragen laufen nicht über gutowski.org: Sie gehen erst auf Klick direkt von deinem Browser an die API, die du testest.

Warum bekomme ich bei manchen APIs keine Antwort?

Browser schützen dich mit einer Regel namens CORS: Eine Website darf die Antwort einer fremden API nur lesen, wenn die API das ausdrücklich erlaubt (Header Access-Control-Allow-Origin). Viele öffentliche APIs und Entwicklungs-Server tun das, andere nicht. In dem Fall kopierst du den curl-Befehl und führst ihn im Terminal aus – dort gilt CORS nicht.

Welche API-Beschreibungen werden unterstützt?

OpenAPI 3.0 und 3.1 sowie Swagger 2.0, jeweils als YAML oder JSON. Verweise innerhalb der Datei ($ref) werden aufgelöst; Verweise auf andere Dateien werden nicht nachgeladen.

Warum ist ein Tabulator ein Fehler?

YAML legt die Struktur über die Einrückung fest und erlaubt dafür nur Leerzeichen. Viele Editoren fügen beim Drücken der Tab-Taste aber ein Tabulatorzeichen ein. Das Tool zeigt die Stelle an; im Eingabefeld hier fügt die Tab-Taste automatisch zwei Leerzeichen ein.

Was bedeuten die Hinweise zu „yes“, „no“ oder „22:22“?

Die heutige Version YAML 1.2 liest „no“ als Text und 22:22 als Text. Ältere Parser nach YAML 1.1 – zum Beispiel PyYAML in Python – machen daraus aber false bzw. die Zahl 1342. Wer auf Nummer sicher gehen will, setzt solche Werte in Anführungszeichen.

Was passiert mit Ankern (&) und Verweisen (*)?

In der Baumansicht und der formatierten YAML-Ausgabe bleiben sie erhalten. Für JSON werden sie aufgelöst, weil JSON keine Verweise kennt – ebenso Merge-Schlüssel (<<: *standard), wie sie oft in docker-compose-Dateien stehen.

Werden meine Zugangsdaten gespeichert?

Nein. API-Schlüssel, Tokens und Passwörter bleiben nur im Arbeitsspeicher dieses Browser-Tabs und gehen ausschließlich mit deiner Testanfrage an die API. Nach dem Schließen der Seite sind sie weg. Deshalb gibt es bewusst auch keinen „Link teilen“.