{"canonical_url":"https://engineer.company/nb/glossary/json-schema/","content_markdown":"# JSON Schema\n\n## Hva det er\n\nJSON Schema er et språk for å beskrive hvordan et stykke JSON skal se ut, og det\ner selv skrevet i JSON. En beskrivelse i språket, et skjema, setter opp reglene:\ndenne verdien er et objekt, den skal ha disse egenskapene, denne er et heltall\npå minst én, den andre en tekststreng på høyst 200 tegn. Et program som kalles\nen validator, tar et skjema og en instans, altså dataene som skal sjekkes, og\nsvarer på om instansen følger skjemaet, og hvis ikke, hvor og hvorfor.\nProsjektet skriver navnet med stor S, JSON Schema, mens et enkelt dokument\nskrevet i språket på engelsk bare heter et schema, med liten s, og på norsk et\nskjema.\n\nSpesifikasjonen vedlikeholdes av JSON Schema-prosjektet på json-schema.org. Den\ngjeldende versjonen er 2020-12 og den forrige 2019-09; tidligere versjoner var\nnummererte drafts, som draft-04 og draft-07, og eldre verktøy og artikler\nomtaler dem fortsatt med de navnene. Teksten består av to deler.\nKjernedokumentet definerer hvordan et skjema behandles, hvordan ett skjema viser\ntil et annet, og medietypen `application/schema+json`, og et annet dokument, om\nvalidering, definerer nøkkelordene som sjekker verdier. De gjeldende dokumentene\nfor 2020-12 er begge datert 16. juni 2022.\n\nHvert nøkkelord legger til én betingelse. `type` angir en av seks primitive\ntyper, null, boolean, object, array, number eller string, eller `integer`, som\nmatcher ethvert tall der desimaldelen er null. For tall finnes `minimum`,\n`maximum` og `multipleOf`; for tekststrenger `minLength`, `maxLength` og\n`pattern`, et regulært uttrykk; for arrayer `minItems`, `maxItems` og\n`uniqueItems`; for objekter `properties`, `required` og `additionalProperties`.\nNøkkelord som `allOf`, `anyOf`, `oneOf` og `not` kombinerer skjemaer, og `$ref`\npeker på et skjema som er definert et annet sted, ofte under `$defs` i samme\ndokument, så en form som er skrevet én gang, kan brukes mange steder. Alt et\nskjema ikke nevner, er tillatt. Det tomme skjemaet, `{}`, godtar enhver instans.\n\nEt skjema kan også angi hvilken versjon av språket det er skrevet i. Nøkkelordet\n`$schema` inneholder adressen til et metaskjema, et skjema som beskriver gyldige\nskjemaer i den versjonen, og spesifikasjonssiden påpeker at metaskjemaet\nvaliderer seg selv. For 2020-12 er adressen\n`https://json-schema.org/draft/2020-12/schema`.\n\n## Hvorfor det er viktig\n\nJSON sier ingenting om betydning. Ethvert velformet dokument kan parses, uansett\nom programmet som leser det, kan bruke det til noe. Uten en nedskrevet\nbeskrivelse har hvert program som leser et dokument, sin egen oppfatning av hva\nsom er gyldig, spredt utover betingelser i koden, og oppfatningene glir fra\nhverandre til en forespørsel feiler i produksjon. Et skjema samler reglene på\nett sted i en form som både mennesker og programmer kan lese, og det kan lagres,\nversjoneres, gjennomgås og publiseres som enhver annen fil.\n\nSpesifikasjonen beskriver formålet sitt bredt: JSON Schema er ment for\nvalidering, dokumentasjon, navigering via hyperlenker og styring av samspillet\nmed JSON-data, og valideringsvokabularet skal også gi brukergrensesnitt som\narbeider med dataene, hint om dem. I praksis betyr det at én beskrivelse kan\navvise feil inndata i kanten av en tjeneste, dokumentere et API, styre feltene\npå en side der folk fyller inn data, og sjekke at JSON-en en språkmodell\nreturnerer, har feltene neste steg forventer.\n\nDet har også blitt det felles grunnlaget som andre spesifikasjoner bygger på.\nOpenAPI 3.1 definerer sitt Schema Object som et supersett av JSON Schema\n2020-12, så innholdet i forespørsler og svar i en API-beskrivelse er beskrevet i\nJSON Schema med noen få tillegg. MCP, protokollen AI-agenter finner og kaller\nverktøy gjennom, beskriver hvert verktøys parametere med et `inputSchema`, som\ner et JSON Schema, og kan beskrive resultatet med et `outputSchema`, som\nklienter bør validere strukturerte resultater mot. En felles beskrivelse kan altså danne grunnlag for en validator, et API-dokument og en agent.\n\n## Slik ser det ut i praksis\n\nSkjemaet nedenfor beskriver inndataene til et verktøy som bestiller et\nleveringsvindu. Det angir versjonen det er skrevet i, lister opp fire egenskaper\nmed reglene deres, sier hvilke tre som må være med, og avviser enhver egenskap\ndet ikke lister opp:\n\n```json\n{\n  \"$schema\": \"https://json-schema.org/draft/2020-12/schema\",\n  \"$id\": \"https://example.com/tools/book-slot.json\",\n  \"title\": \"Bestill et leveringsvindu\",\n  \"type\": \"object\",\n  \"properties\": {\n    \"order\": { \"type\": \"string\", \"pattern\": \"^[0-9]{4,8}$\" },\n    \"date\": { \"type\": \"string\", \"format\": \"date\" },\n    \"pallets\": { \"type\": \"integer\", \"minimum\": 1, \"maximum\": 30 },\n    \"note\": { \"type\": [\"string\", \"null\"], \"maxLength\": 200 }\n  },\n  \"required\": [\"order\", \"date\", \"pallets\"],\n  \"additionalProperties\": false\n}\n```\n\nEn instans som bryter reglene:\n\n```json\n{ \"order\": \"4471\", \"date\": \"27/10/2026\", \"pallets\": 0, \"pallet\": 2 }\n```\n\nInstansen feiler på to punkter. `pallets` ligger under minimumet på 1, og\n`pallet`, en skrivefeil for `pallets`, er en egenskap skjemaet ikke lister opp.\nAt `note` mangler, er ingen feil, for `note` står ikke i `required`; hadde den\nblitt sendt som `null`, ville det også gått gjennom, siden typen tillater null.\nDatoen er den lærerike. Formatet `date` krever året først, og `27/10/2026` er\nikke skrevet slik, men en validator som kjører med standardinnstillingene sine,\ngodtar den, fordi spesifikasjonen gjør `format` til en annotasjon som bare blir\nsjekket når den sjekken er slått på. Slå på sjekken i en validator som kan\nsjekke datoer, og den samme instansen feiler på tre punkter.\n\nEt verktøy beskrevet på den måten er nettopp temaet for siden om\n[programvaren din som verktøy for AI-agenter](/nb/ai-tools/) her på nettstedet.\nDen beskriver hvordan hver operasjon en agent skal ha tilgang til, tilbys som et\nverktøy med navn etter arbeidet det gjør, som å bestille en time eller frigi en\nordre, med typede inndata, feilmeldinger en agent kan handle ut fra, og\nidempotente kall, så et nytt forsøk aldri fører til dobbeltbooking. Beskrivelsen\ner et OpenAPI-dokument generert fra koden, og en MCP-server tilbyr de samme\noperasjonene. Sidens poeng er at en agent stoler på en verktøybeskrivelse også\nnår den er utdatert, og en håndskrevet beskrivelse kan avvike fra implementasjonen. Derfor genereres beskrivelsene fra koden og utover,\ngjennom databasen, API-et, beskrivelsen og klienten, med en sjekk i hvert steg\nsom stopper bygget når to av dem ikke stemmer overens.\n\n## Hvor det går galt\n\n**En egenskap som er listet opp, men aldri påkrevd.** `properties` sjekker bare\nde egenskapene som er til stede, så et objekt som utelater alle sammen, går\ngjennom. At en egenskap må være med, styres av et eget nøkkelord, og utelates\n`required`, er ingenting påkrevd. Skriv `required` ved siden av `properties`\nhver gang, og ha en testsak for hver påkrevde egenskap der nettopp den\negenskapen er fjernet.\n\n**Skrivefeil som slipper gjennom som ekstra egenskaper.** Uten\n`additionalProperties` er enhver egenskap skjemaet ikke lister opp, tillatt, så\n`pallet` går gjennom, og den riktige `pallets` mangler uten at noen merker det.\nSettes nøkkelordet til `false`, lukkes objektet, men nøkkelordet ser bare\n`properties` og `patternProperties` i sitt eget skjemaobjekt. Et skjema som\nbygger på et annet gjennom `allOf` eller `$ref` og deretter lukker seg selv på\nden måten, avviser nettopp de egenskapene det har arvet. Versjon 2020-12 har\n`unevaluatedProperties` for det tilfellet, siden det også regner med egenskapene\nsom er sjekket gjennom `allOf`, `$ref` og de andre nøkkelordene som anvender\nskjemaer på stedet. Bruk `additionalProperties: false` på et skjema som står\nalene, og `unevaluatedProperties: false` på et som er satt sammen.\n\n**`format` som ikke sjekker noe.** Som standard er `format` en annotasjon som\nbare beskriver, ikke en valideringsregel som kan avvise data: spesifikasjonen krever at en\nvalidator som kan sjekke formater, holder den sjekken slått av med mindre noen\nber om den, og selv når den er slått på, kan en validator la et hvilket som\nhelst format passere usjekket. OpenAPI 3.1 følger den samme regelen og legger\ntil at hvor godt formater blir sjekket, varierer mellom implementasjoner. Slå på\nformatsjekk i validatoren du bruker, bevis det med en testsak som skal feile, og\nder et format betyr noe, men ikke kan sjekkes, legg til et `pattern` eller en\nsjekk i koden.\n\n**Mønstre som matcher en del av en verdi.** Et `pattern` er ikke forankret, så\n`[0-9]{4}` godtar `order 4471b`, fordi fire sifre forekommer et sted i verdien;\nspesifikasjonens eget eksempel er at `es` matcher `expression`. Begynn mønsteret\nmed `^` og avslutt det med `$` når hele verdien skal matche. Mønstre følger\nECMA-262-dialekten, og spesifikasjonen anbefaler et lite sett konstruksjoner for\nmønstre som skal oppføre seg likt overalt, så hold deg til enkle tegnklasser,\nkvantorer og ankere.\n\n**Manglende, null og tom behandlet som det samme.** En egenskap som ikke er med,\nen egenskap satt til `null` og en tom tekststreng er tre forskjellige instanser.\n`\"type\": \"string\"` avviser `null`, og en egenskap som ikke står i `required`,\nkan mangle. En klient som sender `null` for å si «ingen verdi» til et skjema som\ner skrevet med tanke på at feltet mangler, feiler på hver eneste slik\nforespørsel. Bestem for hver egenskap hva hver av de tre betyr, og skriv det\nned: `[\"string\", \"null\"]` når null har en betydning, utelatelse fra `required`\nnår egenskapen er valgfri, og `minLength: 1` når en tom tekststreng ikke er en\nverdi.\n\n**Ingen `$schema`, eller to versjoner blandet.** Når roten av et skjema ikke har\nnoe `$schema`, overlater spesifikasjonen oppførselen til implementasjonen, og\nhver validator bruker den versjonen den har som standard. Versjonene skiller seg\nfra hverandre der det betyr noe. I 2019-09 beskrev en array gitt til `items` en\ntuppel; i 2020-12 er den oppgaven flyttet til `prefixItems`, og `items` har\novertatt rollen til `additionalItems`. Sett `$schema` i hver rot, les\nutgivelsesnotatene når du bytter versjon, og valider hvert skjema mot\nmetaskjemaet sitt i CI.\n\n## Les mer\n\n- [JSON Schema Specification](https://json-schema.org/specification) —\n  prosjektets oversikt over den gjeldende versjonen, metaskjemaene og\n  utgivelsesnotatene for hvert tidligere draft.\n- [JSON Schema: A Media Type for Describing JSON Documents](https://json-schema.org/draft/2020-12/json-schema-core)\n  — Core 2020-12: hvordan skjemaer behandles, `$schema`, `$ref` og `$defs`, og\n  nøkkelordene som kombinerer skjemaer.\n- [JSON Schema Validation: A Vocabulary for Structural Validation of JSON](https://json-schema.org/draft/2020-12/json-schema-validation)\n  — nøkkelordene for hver type verdi, `required` og reglene for `format`.\n- [JSON Schema 2020-12 Release Notes](https://json-schema.org/draft/2020-12/release-notes)\n  — hva som er endret siden 2019-09, med `prefixItems` og `$dynamicRef` side om\n  side med det de erstattet.\n- [OpenAPI Specification v3.1.1](https://spec.openapis.org/oas/v3.1.1.html) —\n  Schema Object som et supersett av JSON Schema 2020-12, og `format` som\n  annotasjon som standard.\n- [Model Context Protocol: Tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)\n  — hvordan et verktøy oppgir parameterne og det strukturerte resultatet sitt i\n  JSON Schema.\n\n\u003chttps://engineer.company/nb/glossary/json-schema/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvordan et JSON-dokument kan beskrive gyldige data, hvor den samme beskrivelsen kommer til nytte, og standardinnstillingene som slipper feil data gjennom.","formats":{"gemtext":"https://engineer.company/nb/glossary/json-schema/index.gmi","gopher":"https://engineer.company/nb/glossary/json-schema/gophermap","html":"https://engineer.company/nb/glossary/json-schema/","json":"https://engineer.company/nb/glossary/json-schema/index.json","markdown":"https://engineer.company/nb/glossary/json-schema/index.md","pdf":"https://engineer.company/nb/glossary/json-schema/index.pdf"},"kind":"page","language":"nb","title":"Hva er JSON Schema?","url":"https://engineer.company/nb/glossary/json-schema/","version":1}