ForHosting KIT · Daten & Dateien

YAML oder JSON

Wandeln Sie YAML in das Klammerformat um, das Anwendungen lesen, oder zurück: Im Beispiel behält ein Serverblock mit Host example.com und Port 8080 seine Verschachtelung, und 8080 bleibt eine Zahl. Kommentare, die nicht mitkommen, werden gemeldet statt still verloren. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Gedacht für alle, die mit Konfigurationsdateien arbeiten, etwa in einer Automatisierungs-Pipeline, einem Container-Setup oder einem eigenen Programmierprojekt.

Zwei Schreibweisen für dieselben Daten

YAML, erstmals 2001 veröffentlicht, wurde dafür gebaut, von Menschen gelesen und bearbeitet zu werden: Einrückungen statt Klammern und Platz für Kommentare neben jeder Einstellung. Das Klammerformat, das die meisten Anwendungen lesen, ist das Gegenteil: streng und bequem für Programme, aber mühsam von Hand zu bearbeiten. Kubernetes-Manifeste, GitHub-Actions-Abläufe und docker-compose-Dateien sind YAML, und Dashboards, Prüfwerkzeuge und Konfigurationseditoren für das andere Format können sie nicht direkt lesen. Viele Einstellungen entstehen zudem im Klammerformat und müssen zu YAML werden, sobald sie eine Bereitstellungskette erreichen, die nur YAML versteht.

Was die Umwandlung übersteht und was nicht

Struktur und Typen kommen unversehrt an. Im Beispiel behält die Servergruppe ihren Host example.com und ihren Port 8080 im Inneren; der Port bleibt eine Zahl, die aktive Einstellung bleibt wahr. Bei Kommentaren ist es anders: Das Klammerformat hat keinen Platz für sie. Statt wortlos zu verschwinden, werden sie in einem kurzen Bericht aufgeführt, zusammen mit bestimmten YAML-Ankern, die ebenfalls nicht mitkommen. Die Richtung ergibt sich aus Ihrer Eingabe, oder Sie legen sie fest. Bewahren Sie das ursprüngliche YAML auf, wenn Ihnen die Kommentare wichtig sind.

Beide Richtungen, ein Werkzeug

Für beide Richtungen gilt derselbe Ablauf: einfügen, Ergebnis kopieren oder herunterladen, ohne dass Sie vorher ein eigenes Umwandlungswerkzeug für die jeweilige Richtung suchen müssen oder selbst festlegen, welches Format vorliegt und welches Sie erwarten. Ein zweites, separates Werkzeug für die Gegenrichtung ist damit überflüssig.

Kommentare in YAML gehen verloren

Wichtige Erklärungen zu einzelnen Einstellungen sollten Sie deshalb vor der Umwandlung separat notieren, wenn Sie sie weiterhin benötigen und später nicht neu erfinden möchten. Alle übrigen Werte und die Struktur selbst bleiben davon unberührt.

Häufige Fragen

Bleibt die Struktur beim Hin- und Herwandeln exakt gleich?

Ja, abgesehen von Kommentaren bleibt die Struktur bei der Umwandlung in beide Richtungen erhalten.

Gibt es ein Limit für die Dateigröße?

Die Datei darf bis zu 25 MB groß sein, was für Konfigurationsdateien in aller Regel weit ausreicht.

Ist die Umwandlung wirklich kostenlos?

Ja, im Browser läuft sie kostenlos und ohne Limit.

Brauche ich ein Konto?

Nein, es gibt derzeit keine Konten – die Nutzung im Browser ist ohne Anmeldung möglich.

Woher weiß das Werkzeug, in welche Richtung es umwandeln soll?

Aus dem, was Sie einfügen: YAML wird zum Klammerformat, das Klammerformat wird zu YAML. Wenn Sie sich darauf nicht verlassen möchten, können Sie die Richtung auch selbst festlegen.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/data/yaml-json

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/data/yaml-json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"yaml":"a: 1","json":{"a":1}}'

const res = await fetch("https://api.kit.forhosting.com/data/yaml-json", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "yaml": "a: 1",
    "json": {
      "a": 1
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/yaml-json",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "yaml": "a: 1",
    "json": {
        "a": 1
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/yaml-json", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"yaml":"a: 1","json":{"a":1}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"yaml":"a: 1","json":{"a":1}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/yaml-json", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "yaml": "a: 1",
  "json": {
    "a": 1
  }
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.yaml_json",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_mb 25

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Ein Werkzeug, das YAML in JSON umwandelt und ebenso den umgekehrten Weg beherrscht, ohne dass Sie vorher angeben müssen, welches Format Sie einfügen.

Beide Richtungen, ein Werkzeug

Sie fügen entweder YAML oder JSON ein, das Werkzeug erkennt automatisch, welches Format vorliegt, und gibt das jeweils andere zurück.

Kommentare in YAML gehen verloren

YAML erlaubt Kommentare mit einer Raute, JSON kennt dieses Konzept nicht. Wandeln Sie YAML mit Kommentaren in JSON um, gehen diese Kommentare in der Ausgabe verloren, da es dafür keine Entsprechung gibt.

Typische Konfigurationsdateien

YAML ist die verbreitete Sprache für Konfigurationsdateien in der Softwareentwicklung, etwa für Container-Definitionen, Automatisierungs-Pipelines oder Anwendungseinstellungen. Wer eine solche Datei in einem Werkzeug prüfen möchte, das nur JSON versteht, etwa einen JSON-Schema-Validator, wandelt sie hier zunächst um, statt die Struktur von Hand in JSON nachzubauen und zu pflegen. Das spart gerade bei umfangreichen, mehrfach verschachtelten Konfigurationsdateien spürbar Zeit, auch bei häufigen kleinen Änderungen im laufenden Betrieb.

Direkt im Browser oder per API

Die Umwandlung läuft im Browser, kostenlos und ohne Limit, ohne dass die Datei übertragen wird. Über die API lässt sich dieselbe Umwandlung in einen automatisierten Ablauf einbinden, etwa um bei jeder Änderung einer Konfigurationsdatei automatisch die JSON-Fassung für ein anderes System im Unternehmen neu zu erzeugen, ohne manuellen Eingriff bei jeder Aktualisierung oder Veröffentlichung einer neuen Version. Der Preis pro Anfrage bleibt dabei unabhängig von der Dateigröße stets gleich.

Integrationsbeispiele

Container-Konfiguration prüfen

Lukas Fischer wandelt eine YAML-Konfigurationsdatei für ein Container-Setup in JSON um, um sie gegen ein bestehendes JSON-Schema zu validieren.

Pipeline-Definition für einen Kunden dokumentieren

Schneider IT-Systeme GmbH & Co. KG wandelt eine YAML-Pipeline-Datei in JSON um, um die Struktur in einem internen Dokumentationswerkzeug darzustellen.

Einstellungen eines Website-Generators anpassen

Jonas Weber wandelt die YAML-Konfiguration eines Website-Generators in JSON um, um sie per Skript automatisiert anzupassen.

Technische Fragen

Bleiben Kommentare aus der YAML-Datei im JSON erhalten?

Nein, JSON kennt keine Kommentare. Kommentare aus der YAML-Datei gehen bei der Umwandlung verloren.

Muss ich angeben, ob ich YAML oder JSON einfüge?

Nein, das Format wird automatisch erkannt, die Umwandlung läuft immer in die jeweils andere Richtung.

Vollständige KIT-Dokumentation lesen →

YAML oder JSON

Im Browser ausführen – kostenlos

Zwei Schreibweisen für dieselben Daten

Was die Umwandlung übersteht und was nicht

Beide Richtungen, ein Werkzeug

Kommentare in YAML gehen verloren

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Limits

Fehler

Technische Hinweise

Beide Richtungen, ein Werkzeug

Kommentare in YAML gehen verloren

Typische Konfigurationsdateien

Direkt im Browser oder per API

Integrationsbeispiele

Container-Konfiguration prüfen

Pipeline-Definition für einen Kunden dokumentieren

Einstellungen eines Website-Generators anpassen

Technische Fragen

danke