Hvordan bruke JSON Schema for å validere dataene dine
Hva er et JSON Schema?
Et JSON Schema er en standardisert metode for å beskrive strukturen, nødvendige felt og verdityper i JSON-dataene dine. Tenk på det som en kontrakt eller plan for hvordan gyldig JSON skal se ut. JSON Schema skrives i JSON-format, noe som gjør det både maskinlesbart og enkelt å redigere.
Hvorfor validere med et schema?
- Forebygge feil ved å oppdage ugyldige eller manglende data før de skaper problemer.
- Sikre datakonsistens på tvers av team, apper eller API-er.
- Generere dokumentasjon automatisk fra schemata.
- Hjelpe editorer og verktøy med bedre auto-komplettering og innebygd hjelp.
Et enkelt eksempel: Grunnleggende schema
Her er et enkelt JSON-objekt, etterfulgt av et minimalt schema som validerer strukturen:
{
"name": "Alice",
"age": 30
}
{
"type": "object",
"properties": {
"name": { "type": "string" },
"age": { "type": "number" }
},
"required": ["name", "age"]
}
Dette schemaet sikrer at objektet må ha 'name' (som en tekststreng) og 'age' (som et tall).
Hvordan skrive et tilpasset schema
Du kan definere avanserte regler i schemaet ditt: begrense feltverdier, definere nestede objekter eller sette minimums- og maksimumsverdier. Her er et eksempel som validerer en liste med produkter:
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": { "type": "string" },
"price": { "type": "number", "minimum": 0 },
"tags": {
"type": "array",
"items": { "type": "string" }
}
},
"required": ["id", "price"]
}
}
Bruke JSONValidator.dev for schema-validering
- Lim inn JSON-dataene dine i hovededitoren.
- Lim inn JSON Schema i schema-editoren nedenfor.
- Klikk på Valider JSON mot dette schemaet.
- Gå gjennom valideringsresultatene med eventuelle feil fremhevet og forklart.
Feilsøking av valideringsfeil i schema
Vanlige årsaker til valideringsfeil inkluderer:
- Et påkrevd felt mangler i dataene dine.
- Verditypen stemmer ikke overens med schemaet (f.eks. tekst i stedet for tall).
- Schemaet i seg selv er ugyldig eller inneholder skrivefeil.
Konklusjon
JSON Schema-validering er et kraftfullt verktøy for å gjøre dataene dine robuste og feilsikre. Prøv å lage et schema for dine egne data med vår gratis JSON Schema-generator og valider det live!