Aides OpenAPI

A propos de cet outil

Trois choses que l on fait avec un schema OpenAPI, sur une seule page. "JSON vers schema" deduit un schema de la meme facon que le Generateur de JSON Schema, puis l ecrit dans le dialecte OpenAPI choisi : 3.1, ou un objet schema est du JSON Schema lui meme, ou 3.0, qui n a pas de tableau de types et ecrit un champ nullable comme un seul type plus nullable: true. "Schema vers exemple" construit une valeur JSON qui satisfait un schema, en preferant un example ou un default deja indique par le schema plutot que d en inventer un. "Valider un exemple" verifie un document contre un schema et liste chaque mot cle en echec, en resolvant d abord le mot cle nullable d OpenAPI 3.0 pour qu un schema 3.0 soit verifie correctement plutot qu avec les regles de tableau de types de JSON Schema. Les trois comprennent $ref local, allOf, anyOf et oneOf.

Comment ca marche

1. 1 Choisissez ce que vous voulez faire : JSON vers schema, schema vers exemple, ou valider un exemple.
2. 2 Collez l entree demandee par le mode, ou chargez l exemple.
3. 3 Appuyez sur le bouton. Changez la version d OpenAPI a tout moment pour voir la meme entree ecrite dans l autre dialecte.