ForHosting KIT · Données et fichiers

YAML et JSON

Convertissez du YAML vers le format à accolades que lisent les applications, ou l'inverse : dans l'exemple, un bloc serveur avec l'hôte example.com et le port 8080 garde son imbrication, et 8080 reste un nombre. Les commentaires perdus sont signalés, pas effacés en silence. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Passer de l’un à l’autre est un besoin quotidien des développeurs qui jonglent entre paramétrages et données.

Deux façons d'écrire les mêmes données

Le YAML, publié pour la première fois en 2001, a été conçu pour être lu et modifié par des personnes : des retraits plutôt que des accolades, et de la place pour des commentaires à côté de chaque réglage. Le format à accolades que lisent la plupart des applications est l'inverse : strict et commode pour les programmes, mais pénible à modifier à la main. Les manifestes Kubernetes, les flux GitHub Actions et les fichiers docker-compose sont tous en YAML, que les tableaux de bord, validateurs et éditeurs de configuration conçus pour l'autre format ne savent pas lire directement. Beaucoup de réglages naissent aussi au format à accolades et doivent devenir du YAML dès qu'ils arrivent dans une chaîne de déploiement qui ne parle que YAML. Un seul convertisseur couvre les deux trajets.

Ce qui survit à la conversion, et ce qui se perd

La structure et les types voyagent intacts. Dans l'exemple, le groupe du serveur garde son hôte, example.com, et son port, 8080, imbriqués à l'intérieur ; le port reste un nombre et le réglage actif reste vrai. Les commentaires, eux, sont un cas à part : le format à accolades n'a pas de place pour eux, ils ne peuvent donc pas suivre. Au lieu de disparaître sans prévenir, ils sont listés dans un court compte rendu, avec certaines ancres YAML qui ne survivent pas non plus. Le sens de conversion est déduit de ce que vous collez, ou vous le fixez vous-même. La surprise classique consiste à convertir un fichier commenté, puis à revenir au YAML et à constater que les notes ont disparu : gardez le YAML d'origine si ces commentaires comptent.

Deux sens, un seul outil

Les deux représentent les mêmes données — objets, listes, chaînes, nombres, booléens — mais avec une syntaxe différente. Convertir de l’un vers l’autre ne modifie pas le sens de vos données, seulement leur habillage, ce qui rend l’aller-retour sûr pour vérifier ou reformater un fichier.

Traitement local

Tout se passe dans votre navigateur, sur cette page ; le contenu n’est pas envoyé sur un serveur. C’est appréciable pour un fichier de configuration qui contient parfois des chemins internes ou des paramètres sensibles.

Questions fréquentes

Puis-je m’en servir pour valider un YAML ?

Oui. Si la conversion échoue, le message pointe l’endroit fautif, ce qui aide à corriger une indentation.

Le contenu est-il transmis à un serveur ?

Non, tout est traité localement dans le navigateur ; rien n’est envoyé.

Que deviennent les commentaires du YAML ?

Ils n'ont pas d'équivalent dans l'autre format et ne peuvent donc pas suivre les données. Au lieu de disparaître en silence, ils vous sont signalés dans un court compte rendu, avec certaines ancres qui ne survivent pas non plus à la conversion.

Comment l'outil sait-il dans quel sens convertir ?

D'après ce que vous fournissez : collez du YAML et vous obtenez le format à accolades, collez le format à accolades et vous obtenez du YAML. Si vous préférez ne pas vous y fier, vous pouvez aussi imposer le sens.

Les nombres et les valeurs vrai ou faux gardent-ils leur type ?

Oui. Dans l'exemple, le port 8080 sort comme un nombre, le réglage actif reste une valeur vraie et example.com reste du texte, le tout dans le même groupe imbriqué du serveur.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

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

Exemple de réponse

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

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

max_mb 25

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Cet outil convertit dans les deux sens entre YAML et JSON. Le YAML, très lisible, sert souvent aux fichiers de configuration ; le JSON est le format d’échange des programmes.

Deux sens, un seul outil

Vous collez du YAML pour obtenir du JSON, ou l’inverse : l’outil reconnaît la structure et produit l’autre format.

L’indentation, cœur du YAML

Une tabulation mal placée ou un espace de trop suffit à casser la structure. Là où le JSON s’appuie sur les accolades et les crochets, le YAML repose sur l’indentation. Convertir vers le JSON est justement un bon moyen de vérifier qu’un fichier YAML est correct : s’il se convertit sans erreur, sa syntaxe est saine ; sinon, le message signale l’endroit à corriger.

Les commentaires ne survivent pas

Le YAML autorise les commentaires, précédés d’un dièse, alors que le JSON, non. Lors d’une conversion vers le JSON, ces commentaires disparaissent : c’est une contrainte du format cible, pas un défaut de l’outil. Si vos annotations sont importantes, conservez le fichier YAML d’origine à côté du JSON produit, plutôt que de compter les retrouver après conversion.

Traitement local

Pour intégrer la conversion dans une chaîne automatisée, un appel programmable existe à $0.002 la requête, mais l’usage manuel reste gratuit.

Cas d'intégration

Relire une configuration

Camille Moreau convertit un fichier de configuration YAML en JSON pour l’examiner dans un outil qui n’affiche bien que ce format, puis revient au YAML pour l’éditer.

Vérifier une syntaxe YAML

Thomas Rousseau soupçonne une erreur d’indentation dans un fichier ; la conversion vers JSON lui indique aussitôt où la structure se brise.

Rendre un JSON plus lisible

Sophie Nguyen transforme une réponse JSON dense en YAML pour la relire plus confortablement avant de la commenter avec son équipe.

Questions techniques

La conversion fonctionne-t-elle dans les deux sens ?

Oui. Vous passez du YAML au JSON comme du JSON au YAML ; l’outil détecte le format d’entrée et produit l’autre.

Mes commentaires YAML sont-ils conservés en JSON ?

Non, le JSON ne gère pas les commentaires ; ils disparaissent à la conversion. Gardez le fichier YAML d’origine si vous y tenez.

L’outil est-il gratuit ?

Oui, sans limite dans le navigateur. L’usage programmable, pour automatiser, coûte $0.002 par requête.

Quelle taille de fichier puis-je convertir ?

Jusqu’à 25 Mo.

Consulter la documentation complète du KIT →

Lancer gratuitement

Deux façons d'écrire les mêmes données

Ce qui survit à la conversion, et ce qui se perd

Deux sens, un seul outil

Traitement local

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Limites

Erreurs

Notes techniques

Deux sens, un seul outil

L’indentation, cœur du YAML

Les commentaires ne survivent pas

Traitement local

Cas d'intégration

Relire une configuration

Vérifier une syntaxe YAML

Rendre un JSON plus lisible

Questions techniques

merci