Version de Schéma JSON
Un schéma JSON est écrit dans la syntaxe JSON et est généralement enregistré dans un fichier portant l’extension .json. Il est indiqué en tant que schéma JSON par le mot-clé $schema, qui doit être le premier mot-clé de l’objet de niveau supérieur et a une valeur qui est l’URI d’une version de schéma JSON que vous souhaitez utiliser. Ici, vous trouverez deux exemples affichant 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 explicitement dénommée. À 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 la 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 modifiez 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, voir les liens ci-dessous :
Spécifications de schéma JSON : http://json-schema.org/specification.html
Notes de release Draft-06 : http://json-schema.org/draft-06/json-schema-release-notes.html
Notes de release Draft-07 : http://json-schema.org/draft-07/json-schema-release-notes.html
Draft 2019-09 (anciennement 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.