Formateur OpenAPI en ligne — Beautifier JSON et YAML

Formatez vos documents OpenAPI 3.0–3.2 (JSON ou YAML) dans le navigateur — indentation 2 ou 4, sans envoi serveur.

Chargement…
Documentation Formater OpenAPI
Pretty-print OpenAPI JSON ou YAML dans le navigateur.

Notes développeur

• Pretty-print générique (JSON.stringify / yaml.dump) — pas de réordonnancement OpenAPI. • Le type d’entrée est conservé : JSON → JSON ; YAML → YAML. • Les commentaires YAML sont perdus au formatage. • Les versions openapi numériques en YAML (ex. 3.0) sont normalisées en chaînes (3.0.0). • Limite 512 Kio.

Cas d’usage

• Nettoyer une spec OpenAPI JSON/YAML avant revue. • Normaliser l’indentation (2 ou 4 espaces) pour les diffs PR. • Enchaîner avec Valider OpenAPI après formatage.

Exemples

JSON compact → indenté

Avant

{"openapi":"3.1.0","info":{"title":"Pets API","version":"1.0.0","description":"Simple pet store API"},"paths":{"/pets":{"get":{"operationId":"listPets","tags":["pets"],"summary":"List pets","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Pet"}}}}}}}}},"components":{"schemas":{"Pet":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}

Après

{ "openapi": "3.1.0", "info": { "title": "Pets API", "version": "1.0.0", "description": "Simple pet store API" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": [ "pets" ], "summary": "List pets", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Pet" } } } } } } } } }, "components": { "schemas": { "Pet": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } } } }

YAML conservé en YAML

Avant

openapi: "3.0.3" info: title: Pets version: 1.0.0 paths: {}

Après

openapi: "3.0.3" info: title: Pets version: 1.0.0 paths: {}

FAQ Formater OpenAPI

Questions fréquentes

Le format conserve-t-il JSON vs YAML ?

Oui. Une entrée JSON produit du JSON indenté ; une entrée YAML produit du YAML via yaml.dump. Les commentaires YAML ne sont pas conservés.

Est-ce un pretty-printer OpenAPI-aware ?

Non — pretty-print générique (JSON.stringify / yaml.dump). Les clés ne sont pas réordonnées selon les conventions OpenAPI.

Et openapi: 3.0 en nombre YAML ?

Les versions numériques sont normalisées en chaînes (3 → 3.0.0, 3.0 → 3.0.0) avant sortie.

Quelles versions OpenAPI ?

OpenAPI 3.0, 3.1 et 3.2. Swagger 2.0 n’est pas supporté.

Outils OpenAPI du cluster

Convertisseurs, encodeurs, formateurs et minificateurs au même endroit ? Outils développeurs Ouvrez le catalogue des outils développeurs.