Vai al contenuto

JSON Schema

JSON Schema descrive struttura e vincoli dei dati JSON. Un validatore verifica le regole; rispettarle non dimostra ancora la correttezza funzionale.

API e contratti dati

JSON Schema è un linguaggio per descrivere struttura e vincoli dei dati JSON. Comprende tipi di dati e regole per le proprietà. Un validatore può verificare se dati concreti rispettano lo schema fornito.

Distinguere sintassi JSON valida e dati adeguati

In una ricezione ordini fittizia, il campo quantity deve contenere un intero. Il valore numerico 2 e la stringa "2" sono tipi di valore diversi. Un documento JSON sintatticamente valido non soddisfa quindi automaticamente la regola concordata per il campo.

Definire esplicitamente i campi obbligatori

La documentazione JSON Schema spiega che le proprietà elencate non sono automaticamente obbligatorie. Le informazioni richieste devono essere specificate nello schema. La panoramica descrive la verifica tramite un validatore. Anche una verifica superata non conferma che la quantità appartenga all’ordine corretto o sia stata elaborata nell’ERP. Controllo della struttura, associazione all’ordine corretto ed elaborazione riuscita richiedono prove adeguate distinte.

Fonti