{"canonical_url":"https://engineer.company/da/glossary/json-schema/","content_markdown":"# JSON Schema\n\n## Hvad det er\n\nJSON Schema er et sprog til at beskrive, hvordan et stykke JSON skal se ud, og\ndet er selv skrevet i JSON. En beskrivelse i sproget, et skema, opstiller\nreglerne: denne værdi er et objekt, den skal have disse egenskaber, den her er\net helt tal på mindst én, den der en tekststreng på højst 200 tegn. Et program,\nder kaldes en validator, tager et skema og en instans, altså de data, der skal\ntjekkes, og svarer på, om instansen overholder skemaet, og hvis ikke, hvor og\nhvorfor. Projektet skriver navnet med stort S, JSON Schema, mens et enkelt\ndokument skrevet i sproget på engelsk blot hedder et schema, med lille s, og på\ndansk et skema.\n\nSpecifikationen vedligeholdes af JSON Schema-projektet på json-schema.org. Den\naktuelle version er 2020-12 og den forrige 2019-09; tidligere versioner var\nnummererede drafts, som draft-04 og draft-07, og ældre værktøjer og artikler\nomtaler dem stadig ved de navne. Teksten består af to dele. Kernedokumentet\ndefinerer, hvordan et skema behandles, hvordan ét skema henviser til et andet,\nog medietypen `application/schema+json`, og et andet dokument, om validering,\ndefinerer de nøgleord, der tjekker værdier. De gældende dokumenter for 2020-12\ner begge dateret 16. juni 2022.\n\nHvert nøgleord tilføjer én betingelse. `type` angiver en af seks primitive\ntyper, null, boolean, object, array, number eller string, eller `integer`, der\nmatcher ethvert tal, hvis brøkdel er nul. Tal tager `minimum`, `maximum` og\n`multipleOf`; tekststrenge tager `minLength`, `maxLength` og `pattern`, et\nregulært udtryk; arrays tager `minItems`, `maxItems` og `uniqueItems`; objekter\ntager `properties`, `required` og `additionalProperties`. Nøgleord som `allOf`,\n`anyOf`, `oneOf` og `not` kombinerer skemaer, og `$ref` peger på et skema, der\ner defineret et andet sted, ofte under `$defs` i samme dokument, så en form, der\ner skrevet én gang, kan bruges mange steder. Alt, hvad et skema ikke nævner, er\ntilladt. Det tomme skema, `{}`, accepterer enhver instans, der findes.\n\nEt skema kan også angive, hvilken version af sproget det er skrevet i.\nNøgleordet `$schema` rummer adressen på et metaskema, et skema, der beskriver\ngyldige skemaer i den version, og specifikationssiden bemærker, at metaskemaet\nvaliderer sig selv. For 2020-12 er adressen\n`https://json-schema.org/draft/2020-12/schema`.\n\n## Hvorfor det betyder noget\n\nJSON siger intet om betydning. Ethvert velformet dokument kan parses, uanset om\nprogrammet, der læser det, kan bruge det til noget. Uden en nedskrevet\nbeskrivelse har hvert program, der læser et dokument, sin egen opfattelse af,\nhvad gyldigt er, spredt ud over betingelser i koden, og de opfattelser glider\nfra hinanden, indtil en forespørgsel fejler i produktion. Et skema samler\nreglerne ét sted i en form, som både mennesker og programmer kan læse, og det\nkan gemmes, versioneres, gennemgås og udgives som enhver anden fil.\n\nSpecifikationen beskriver sit formål bredt: JSON Schema er beregnet til\nvalidering, dokumentation, navigation via hyperlinks og styring af interaktionen\nmed JSON-data, og valideringsordforrådet skal også give brugerflader, der\narbejder med dataene, hints om dem. I praksis betyder det, at én beskrivelse kan\nafvise forkert input i kanten af en tjeneste, dokumentere et API, drive en\nformular og tjekke, at den JSON, en sprogmodel returnerer, har de felter, næste\ntrin forventer.\n\nDet er også blevet det fælles grundlag, som andre specifikationer bygger på.\nOpenAPI 3.1 definerer sit Schema Object som en overmængde af JSON Schema\n2020-12, så indholdet af forespørgsler og svar i en API-beskrivelse er beskrevet\ni JSON Schema med nogle få tilføjelser. MCP, protokollen, som AI-agenter finder\nog kalder værktøjer gennem, beskriver hvert værktøjs parametre med et\n`inputSchema`, der er et JSON Schema, og kan beskrive resultatet med et\n`outputSchema`, som klienter bør validere strukturerede resultater mod. En fælles beskrivelse kan altså danne grundlag for en validator, et API-dokument og en agent.\n\n## Sådan ser det ud i praksis\n\nSkemaet nedenfor beskriver input til et værktøj, der booker en leveringstid. Det\nangiver den version, det er skrevet i, opregner fire egenskaber med deres\nregler, siger, hvilke tre der skal være til stede, og afviser enhver egenskab,\ndet ikke opregner:\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\": \"Book en leveringstid\",\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, der bryder reglerne:\n\n```json\n{ \"order\": \"4471\", \"date\": \"27/10/2026\", \"pallets\": 0, \"pallet\": 2 }\n```\n\nInstansen fejler på to punkter. `pallets` ligger under minimum på 1, og\n`pallet`, en tastefejl for `pallets`, er en egenskab, skemaet ikke opregner. At\n`note` mangler, er ingen fejl, for `note` står ikke i `required`; var den sendt\nsom `null`, ville det også gå igennem, da dens type tillader null. Datoen er den\nlærerige. Formatet `date` kræver året først, og `27/10/2026` er ikke skrevet\nsådan, men en validator, der kører med sine standardindstillinger, accepterer\nden, fordi specifikationen gør `format` til en annotation, der kun bliver\ntjekket, når det tjek er slået til. Slå det tjek til i en validator, der tjekker\ndatoer, og den samme instans fejler på tre punkter.\n\nEt værktøj beskrevet på den måde er netop emnet for siden om\n[din software som værktøjer til AI-agenter](/da/ai-tools/) her på sitet. Den\nbeskriver, hvordan hver operation, en agent skal kunne udføre, som at booke en\ntid eller frigive en ordre, stilles til rådighed som et værktøj med typede\ninput, fejlbeskeder, en agent kan handle på, og idempotente kald, så et nyt\nforsøg aldrig booker to gange. Beskrivelsen er et OpenAPI-dokument genereret fra\nkoden, og en MCP-server stiller de samme operationer til rådighed. Sidens pointe\ner, at en agent stoler på et værktøjs beskrivelse, også når den er forældet, og en håndskrevet beskrivelse kan glide fra implementeringen. Derfor genereres beskrivelserne fra koden og udad, gennem databasen,\nAPI'et, beskrivelsen og klienten, med et tjek i hvert led, der får buildet til\nat fejle, når to af dem er uenige.\n\n## Hvor det går galt\n\n**En opregnet egenskab, der aldrig er påkrævet.** `properties` tjekker kun de\negenskaber, der er til stede, så et objekt, der udelader dem alle, går igennem.\nTilstedeværelse er et separat nøgleord, og udelades `required`, er intet\npåkrævet overhovedet. Skriv `required` ved siden af `properties` hver gang, og\nhav en testsag for hver påkrævet egenskab, hvor netop den egenskab er fjernet.\n\n**Tastefejl, der slipper igennem som ekstra egenskaber.** Uden\n`additionalProperties` er enhver egenskab, skemaet ikke opregner, tilladt, så\n`pallet` går igennem, og det rigtige `pallets` mangler i al stilhed. Sættes\nnøgleordet til `false`, lukkes objektet, men nøgleordet ser kun de `properties`\nog `patternProperties`, der står i dets eget skemaobjekt. Et skema, der bygger\npå et andet gennem `allOf` eller `$ref` og derefter lukker sig selv på den måde,\nafviser netop de egenskaber, det har arvet. Version 2020-12 har\n`unevaluatedProperties` til det tilfælde, da det også medregner de egenskaber,\nder er tjekket gennem `allOf`, `$ref` og de andre nøgleord, der anvender skemaer\npå stedet. Brug `additionalProperties: false` på et skema, der står alene, og\n`unevaluatedProperties: false` på et, der er sammensat.\n\n**`format`, der intet tjekker.** Som standard er `format` en annotation, der kun\nbeskriver, og ikke en assertion, der afviser: specifikationen kræver, at en\nvalidator, der kan tjekke formater, holder det tjek slået fra, medmindre der\nbliver bedt om det, og selv når det er slået til, må en validator lade ethvert\nformat passere ukontrolleret. OpenAPI 3.1 følger samme regel og tilføjer, at\nhvor godt formater bliver tjekket, varierer mellem implementeringer. Slå\nformattjek til i den validator, I bruger, bevis det med en testsag, der burde\nfejle, og hvor et format betyder noget, men ikke kan tjekkes, så tilføj et\n`pattern` eller et tjek i koden.\n\n**Mønstre, der matcher en del af en værdi.** Et `pattern` er ikke forankret, så\n`[0-9]{4}` accepterer `order 4471b`, fordi fire cifre optræder et sted i\nværdien; specifikationens eget eksempel er, at `es` matcher `expression`. Begynd\nmønstret med `^` og afslut det med `$`, når hele værdien skal matche. Mønstre\nfølger ECMA-262-dialekten, og specifikationen anbefaler et lille sæt\nkonstruktioner til mønstre, der skal opføre sig ens overalt, så hold jer til\nsimple tegnklasser, kvantorer og ankre.\n\n**Manglende, null og tom behandlet som ét.** En egenskab, der er fraværende, en\negenskab sat til `null` og en tom tekststreng er tre forskellige instanser.\n`\"type\": \"string\"` afviser `null`, og en egenskab, der ikke står i `required`,\nmå være fraværende. En klient, der sender `null` for at sige »ingen værdi« til\net skema, der er skrevet til fravær, fejler på hver eneste af den slags\nforespørgsler. Beslut for hver egenskab, hvad hver af de tre betyder, og skriv\ndet ned: `[\"string\", \"null\"]`, når null bærer betydning, udeladelse fra\n`required`, når egenskaben er valgfri, og `minLength: 1`, når en tom tekststreng\nikke er en værdi.\n\n**Intet `$schema`, eller to versioner blandet.** Når roden af et skema ikke har\nnoget `$schema`, overlader specifikationen opførslen til implementeringen, og\nhver validator anvender den version, den nu har som standard. Versionerne\nadskiller sig på steder, der betyder noget. I 2019-09 beskrev et array givet til\n`items` en tupel; i 2020-12 hører den opgave til `prefixItems`, og `items` har\novertaget rollen fra `additionalItems`. Sæt `$schema` i hver rod, følg\nudgivelsesnoterne, når I skifter mellem versioner, og valider hvert skema mod\ndets metaskema i CI.\n\n## Læs mere\n\n- [JSON Schema Specification](https://json-schema.org/specification) —\n  projektets oversigt over den aktuelle version, dens metaskemaer og\n  udgivelsesnoterne 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 skemaer behandles, `$schema`, `$ref` og `$defs`, og de\n  nøgleord, der kombinerer skemaer.\n- [JSON Schema Validation: A Vocabulary for Structural Validation of JSON](https://json-schema.org/draft/2020-12/json-schema-validation)\n  — nøgleordene for hver type værdi, `required` og reglerne for `format`.\n- [JSON Schema 2020-12 Release Notes](https://json-schema.org/draft/2020-12/release-notes)\n  — hvad der er ændret siden 2019-09, med `prefixItems` og `$dynamicRef` side om\n  side med det, de afløste.\n- [OpenAPI Specification v3.1.1](https://spec.openapis.org/oas/v3.1.1.html) —\n  Schema Object som en overmængde af JSON Schema 2020-12, og `format` som\n  annotation som standard.\n- [Model Context Protocol: Tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)\n  — hvordan et værktøj erklærer sine parametre og sit strukturerede output i\n  JSON Schema.\n\n\u003chttps://engineer.company/da/glossary/json-schema/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvordan et JSON-dokument kan beskrive gyldige data, hvor den samme beskrivelse kommer i brug, og de standardindstillinger, der lukker forkerte data ind.","formats":{"gemtext":"https://engineer.company/da/glossary/json-schema/index.gmi","gopher":"https://engineer.company/da/glossary/json-schema/gophermap","html":"https://engineer.company/da/glossary/json-schema/","json":"https://engineer.company/da/glossary/json-schema/index.json","markdown":"https://engineer.company/da/glossary/json-schema/index.md","pdf":"https://engineer.company/da/glossary/json-schema/index.pdf"},"kind":"page","language":"da","title":"Hvad er JSON Schema?","url":"https://engineer.company/da/glossary/json-schema/","version":1}