Générateur de schéma JSON

Ce que l’inférence fait bien

• Types : chaîne, nombre, entier, booléen, null, tableau, objet.
• Nullabilité : un champ qui est null dans un échantillon et une chaîne dans un autre devient ["string", "null"].
• Éléments de tableau : les tableaux homogènes produisent un seul schéma items ; les tableaux hétérogènes produisent prefixItems.
• Énumérations : si toutes les valeurs observées proviennent d’un petit ensemble (configurable, par défaut 10 valeurs distinctes), émet une enum.
• Requis : avec plusieurs échantillons, l’intersection des clés devient requis ; avec un échantillon, toutes les clés sont requises à moins que vous ne choisissiez de ne pas les inclure.
• Formats : les chaînes correspondant aux dates ISO-8601, aux e-mails ou aux URI obtiennent un format inféré.

Ce que l’inférence ne peut pas savoir

• Intention vs exemple : un échantillon age: 25 infère type: integer, mais ne peut pas savoir que vous acceptez également null. Passez plusieurs échantillons qui couvrent les cas limites.
• Contraintes : minLength, maximum, pattern, vous devez les ajouter manuellement. L’inférence ne devine pas les limites à partir des échantillons.
• Logique métier : “exactement un de ces trois champs doit être défini” nécessite oneOf, non inférable.
• Références : le générateur émet un schéma plat. Si vous souhaitez factoriser des formes répétées dans $defs, faites-le après la génération.

Exemple de sortie

À partir d’un seul échantillon :

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

Le schéma inféré (brouillon 2020-12) :

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Erreurs courantes

• Inférer à partir d’un seul échantillon. Le schéma sera trop ajusté, chaque champ devient requis, aucune tolérance pour null. Alimentez toujours au moins 5-10 échantillons variés.
• Utiliser integer quand vous vouliez dire number. Si un échantillon a une décimale, le type inféré devient number ; si tous sont entiers, il devient integer. Pour les champs qui pourraient être l’un ou l’autre, incluez un échantillon décimal.
• Oublier les champs optionnels. Un champ présent dans 4 des 5 échantillons mais manquant dans 1 devient optionnel, intentionnel. Si les 5 échantillons l’incluent, le schéma le marquera comme requis même s’il est en réalité optionnel dans votre API.