# Générateur de schéma JSON

Générez un schéma JSON à partir d’un exemple JSON. Le générateur déduit les types, les propriétés obligatoires, les schémas des éléments de tableau et les formats de chaîne courants tels que date-time, email, uri et uuid, puis écrit un schéma pour le brouillon 2020-12, 2019-09 ou draft-07. Vous pouvez l’utiliser pour valider des requêtes, documenter une API ou générer des formulaires.

## Foire aux questions

### Quels brouillons de schéma JSON sont pris en charge ?

Le brouillon 2020-12, la version actuelle utilisée par OpenAPI 3.1, le brouillon 2019-09 et draft-07, encore attendu par de nombreux validateurs et outils plus anciens. Le choix définit le $schema URL ; les mots-clés écrits par le générateur ont la même signification dans les trois versions.

### Comment les propriétés obligatoires sont-elles déterminées ?

Une propriété est répertoriée comme obligatoire lorsqu’elle apparaît dans chaque exemple de cet objet. Dans un tableau d’objets, une clé absente de certains éléments n’est pas incluse dans la liste des propriétés obligatoires. Désactivez l’option pour générer un schéma sans aucune liste de propriétés obligatoires.

### Quels formats de chaîne sont détectés ?

date-time, date, time, email, uri, uuid et ipv4. Un format est ajouté uniquement si toutes les valeurs d’exemple de la propriété lui correspondent ; une seule valeur en texte libre suffit donc à laisser la propriété en simple chaîne. Désactivez la détection si vous ne voulez pas de mots-clés de format.

### Le schéma distingue-t-il les entiers des nombres décimaux ?

Oui. Une propriété dont tous les exemples sont des nombres entiers reçoit le type integer. Dès qu’un exemple comporte une partie fractionnaire, le type devient number, qui accepte également les entiers.

### Comment les tableaux sont-ils décrits ?

Un tableau reçoit le type array et un schéma items construit à partir de l’ensemble de ses éléments. Les objets d’un tableau sont fusionnés : le schéma items répertorie ainsi chaque clé présente dans au moins un élément, et la liste des propriétés obligatoires se limite aux clés présentes dans tous les éléments.

### Que se passe-t-il avec des types mixtes ?

Lorsqu’une propriété contient des valeurs simples de types différents, par exemple une chaîne dans un élément et null dans un autre, le schéma les répertorie dans un tableau de types, par exemple ["string", "null"]. Lorsque des objets ou des tableaux sont mélangés à d’autres types, le générateur utilise anyOf avec un schéma pour chacun.

### Le générateur ajoute-t-il additionalProperties ou des limites ?

Non. Un exemple ne permet pas de déterminer quelles clés supplémentaires sont interdites ni quelles sont les valeurs minimales et maximales réelles ; le générateur omet donc additionalProperties, minLength, maximum et les mots-clés similaires. Ajoutez-les manuellement selon les besoins de vos données.

### Puis-je valider des données avec le résultat ?

Oui. Collez le schéma et vos données dans le validateur de schéma JSON, ou utilisez-les avec une bibliothèque comme Ajv. Vérifiez d’abord le schéma : il reflète votre exemple. Si un champ peut être absent ou null dans les données réelles, mais pas dans l’exemple, une petite modification est nécessaire.

### Puis-je utiliser le schéma dans OpenAPI ?

OpenAPI 3.1 utilise directement le schéma JSON-12 2020 ; le schéma généré peut donc être placé sous components/schemas après suppression de la ligne $schema. OpenAPI 3.0 utilise un sous-ensemble plus ancien ; remplacez-y les tableaux de types par nullable.

### Quelle est la taille maximale de l’entrée ?

Jusqu’à 1,000,000 caractères de JSON, imbriqués sur 64 niveaux maximum. L’échantillon est analysé uniquement pour cette requête et n’est pas stocké.

Votre publicité ici ?

[Envoyez-nous un e-mail](mailto:hi@dennn.is?subject=Publicit%C3%A9%20sur%20OneClick%20Pro)

[Annonce 433 outils pour vos agents IA via un seul serveur MCP.](https://multitaskai.com/fr/?ref=oneclickpro)
