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) — tri récursif des clés optionnel pour des diffs stables. Le type d’entrée est préservé : JSON → JSON ; YAML → YAML. Auto-format au collage/upload/échantillon ; les edits manuels passent par Formater (⌘↵). 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). Max 512 Kio.

Options

Indentation
Espaces par niveau pour JSON.stringify / yaml.dump (2 ou 4).
Trier les clés
Désactivé par défaut (ordre des clés préservé). Activé : tri récursif des clés objets pour des diffs PR stables ; l’ordre des éléments de tableaux est inchangé.

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 ?

Le pretty-print reste générique (JSON.stringify / yaml.dump). Activez Trier les clés pour un ordre alphabétique récursif (diffs stables). Ce n’est pas un réordonnancement OpenAPI-aware (paths avant components, etc.).

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é.

API & schémas

Outils OpenAPI pour formater, valider et analyser vos specs.

Découvrez les autres catégories d'outils