Version de Schéma JSON
Un schéma JSON est écrit dans la syntaxe JSON et sera généralement enregistré dans un fichier avec une extension .json. Il est indiqué en tant qu'un schéma JSON avec le mot-clé $schema, qui doit être le premier mot-clé de l'objet de niveau supérieur et ont une valeur qui est l'URI de la version schéma JSON que vous souhaitez utiliser. Ici, vous trouverez deux exemple montrant comment utiliser le mot-clé $schema :
{
"$schema": "http://json-schema.org/draft-07/schema#",
...
}
{
"$schema": "http://json-schema.org/schema#",
...
}
Dans le premier exemple ci-dessus, la version de schéma est nommé explicitement. À la place de choisir explicitement une version, vous pouvez utiliser "http://json-schema.org/schema#", comme dans le deuxième exemple ci-dessus. Ceci indique que la version de schéma à utiliser est la version la plus récente (actuellement <%JSON-SCHEMA-LATEST%>).
Dans le Mode Schéma JSON, vous pouvez changer la version dans la liste de choix dans la barre en haut de la fenêtre principale (voir capture d'écran ci-dessous).
Fonctions des nouvelles versions de schéma qui ne sont pas définies dans une version plus ancienne
Si vous utilisez une fonction ou une version de schéma plus récente et que vous passez ensuite à une version plus ancienne qui ne prend pas en charge cette fonction, la chose suivante se produit :
•Un message apparaît vous invitant à supprimer/reconvertir la fonction ou garder la fonction
•Si vous le conservez, le composant ou le détail correspondant à la nouvelle fonction est affiché dans un texte de couleur orange. Par exemple, si une valeur a été définie pour le mot-clé const (nouveauté dans draft-06) et que vous changez la version de schéma à draft-04, alors la valeur du mot-clé const est affichée en orange.
Versions de Schéma JSON
Pour plus d'informations concernant les spécifications de Schéma JSON, en particulier en ce qui concerne les fonctions supplémentaires avec chaque version, vois les liens ci-dessous :
Spécification de Schéma JSON : http://json-schema.org/specification.html
Draft-06 notes de version : http://json-schema.org/draft-06/json-schema-release-notes.html
Draft-07 notes de version : http://json-schema.org/draft-07/json-schema-release-notes.html
Draft 2019-09 (avant Draft-08) : http://json-schema.org/specification-links.html#2019-09-formerly-known-as-draft-8
Draft 2020-12 : http://json-schema.org/specification-links.html#2020-12
De plus, le schéma OpenAPI (oas-3.1) et les hyper-schémas suivants sont disponibles : draft-04-hyper, draft-06-hyper, draft-07-hyper, 2019-09-hyper.
Les liens vers les schémas principaux et hyper schémas sont disponibles ici : http://json-schema.org/specification-links.html.