Saltar al contenido

JSON Schema

JSON Schema describe la estructura y las restricciones de datos JSON. Un validador revisa las reglas; cumplirlas aún no demuestra corrección de negocio.

APIs y contratos de datos

JSON Schema es un lenguaje para describir la estructura y las restricciones de los datos JSON. Incluye tipos de datos y reglas para propiedades. Un validador puede comprobar si datos concretos cumplen el esquema proporcionado.

Distinguir sintaxis JSON válida y datos adecuados

En una recepción de pedidos ficticia, el campo quantity debe contener un entero. El valor numérico 2 y la cadena "2" son tipos de valor distintos. Un documento JSON sintácticamente válido no cumple automáticamente la regla acordada para el campo.

Definir expresamente los campos obligatorios

La documentación de JSON Schema explica que las propiedades enumeradas no son automáticamente obligatorias. La información requerida debe indicarse de forma correspondiente en el esquema. La presentación describe la comprobación mediante un validador. Incluso superar la validación no confirma que la cantidad corresponda al pedido correcto o se haya procesado en el ERP. La estructura, la vinculación al pedido correcto y el procesamiento correcto requieren pruebas adecuadas por separado.

Fuentes