Versión del esquema JSON
Un esquema JSON se escribe con sintaxis JSON y se suele guardar en un archivo con extensión .json. La palabra clave $schema indica que se trata de un esquema JSON y debe ser la primera palabra clave del objeto de nivel superior y tener como valor el URI de la versión del esquema JSON que quiera usar. Estos son dos ejemplos de cómo usar la palabra clave $schema:
{
"$schema": "http://json-schema.org/draft-07/schema#",
...
}
{
"$schema": "http://json-schema.org/schema#",
...
}
En el primero de los ejemplos anteriores la versión del esquema se menciona de forma explícita. Si falta el nombre de la versión, como en el segundo de los ejemplos anteriores, entonces eso indica que la versión del esquema que se debe usar es la más reciente (actualmente 2020-12 and 2019-09-hyper).
En la vista JSON Schema puede cambiar a versión en el cuadro combinado de la barra que se encuentra en la parte superior de la ventana principal (imagen siguiente).
Opciones de las versiones nuevas del esquema que no existen en versiones anteriores
Si usa una opción de una de las versiones más recientes del esquema y después cambia a una versión anterior del mismo que no contiene esa opción, entonces ocurre lo siguiente:
•aparece un mensaje preguntando si quiere eliminar/convertir esa opción o mantenerla
•el componente que corresponda a la versión no compatible aparecerá resaltado en color naranja. Por ejemplo, si se define un valor para la palabra clave const (nueva en la versión draft-06) y cambia la versión del esquema a draft-04, entonces el valor de const aparecerá en naranja.
Versiones del esquema JSON
Para más información sobre las especificaciones del esquema JSON, en concreto sobre opciones específicas de cada versión, consulte estos enlaces:
Especificación JSON Schema: http://json-schema.org/specification.html
Notas sobre el borrador Draft-06: http://json-schema.org/draft-06/json-schema-release-notes.html
Notas sobre el borrador Draft-07: http://json-schema.org/draft-07/json-schema-release-notes.html
Borrador Draft 2019-09 (antiguo Draft-08): http://json-schema.org/specification-links.html#2019-09-formerly-known-as-draft-8
Borrador Draft 2020-12: http://json-schema.org/specification-links.html#2020-12
También están disponibles el esquema de OpenAPI (oas-3.1) y estos hiperesquemas: draft-04-hyper, draft-06-hyper, draft-07-hyper, 2019-09-hyper.
Aquí puede encontrar enlaces a los esquemas nucleares y a los hiperesquemas: http://json-schema.org/specification-links.html.