{"canonical_url":"https://engineer.company/sv/glossary/json-schema/","content_markdown":"# JSON Schema\n\n## Vad det är\n\nJSON Schema är ett språk för att beskriva hur ett stycke JSON ska se ut, och det\när självt skrivet i JSON. En beskrivning i språket, ett schema, ställer upp\nreglerna: det här värdet är ett objekt, det ska ha de här egenskaperna, ett annat\när ett heltal på minst ett, ett tredje en textsträng på högst 200 tecken. Ett\nprogram som kallas validator tar ett schema och en instans, alltså de data som\nska kontrolleras, och svarar på om instansen följer schemat och, om inte, var\noch varför. Projektet skriver namnet med stort S, JSON Schema, medan ett enskilt\ndokument skrivet i språket bara kallas ett schema, med litet s, på svenska lika\nväl som på engelska.\n\nSpecifikationen underhålls av JSON Schema-projektet på json-schema.org. Den\ngällande versionen är 2020-12 och den förra 2019-09; tidigare versioner var\nnumrerade utkast, som draft-04 och draft-07, och äldre verktyg och artiklar\nkallar dem fortfarande vid de namnen. Texten består av två delar. Kärndokumentet\ndefinierar hur ett schema behandlas, hur ett schema hänvisar till ett annat och\nmedietypen `application/schema+json`, och ett annat dokument, om validering,\ndefinierar de nyckelord som kontrollerar värden. De gällande dokumenten för\n2020-12 är båda daterade den 16 juni 2022.\n\nVarje nyckelord lägger till ett villkor. `type` anger en av sex primitiva typer,\nnull, boolean, object, array, number eller string, eller `integer`, som matchar\nvarje tal vars decimaldel är noll. För tal finns `minimum`, `maximum` och\n`multipleOf`; för textsträngar `minLength`, `maxLength` och `pattern`, ett\nreguljärt uttryck; för arrayer `minItems`, `maxItems` och `uniqueItems`; för\nobjekt `properties`, `required` och `additionalProperties`. Nyckelord som\n`allOf`, `anyOf`, `oneOf` och `not` kombinerar scheman, och `$ref` pekar på ett\nschema som är definierat någon annanstans, ofta under `$defs` i samma dokument,\nså att en form som skrivs en gång kan användas på många ställen. Allt som ett\nschema inte nämner är tillåtet. Det tomma schemat, `{}`, godtar varje instans.\n\nEtt schema kan också ange vilken version av språket det är skrivet i.\nNyckelordet `$schema` innehåller adressen till ett metaschema, ett schema som\nbeskriver giltiga scheman i den versionen, och specifikationssidan påpekar att\nmetaschemat validerar sig självt. För 2020-12 är adressen\n`https://json-schema.org/draft/2020-12/schema`.\n\n## Varför det spelar roll\n\nJSON säger ingenting om betydelse. Varje välformat dokument går att parsa,\noavsett om programmet som läser det kan använda det till något. Utan en\nnedskriven beskrivning har varje program som läser ett dokument sin egen\nuppfattning om vad som är giltigt, utspridd i villkor i koden, och\nuppfattningarna glider isär tills en begäran misslyckas i produktion. Ett schema\nsamlar reglerna på ett ställe i en form som både människor och program kan läsa,\noch det kan sparas, versioneras, granskas och publiceras som vilken annan fil\nsom helst.\n\nSpecifikationen beskriver sitt syfte brett: JSON Schema är tänkt för validering,\ndokumentation, navigering via hyperlänkar och styrning av interaktionen med\nJSON-data, och valideringsvokabulären ska också ge användargränssnitt som\narbetar med datan ledtrådar om den. I praktiken betyder det att en enda\nbeskrivning kan avvisa felaktiga indata i kanten av en tjänst, dokumentera ett\nAPI, styra fälten på en sida där folk fyller i uppgifter och kontrollera att den\nJSON som en språkmodell returnerar har de fält som nästa steg väntar sig.\n\nDet har också blivit den gemensamma grund som andra specifikationer bygger på.\nOpenAPI 3.1 definierar sitt Schema Object som en övermängd av JSON Schema\n2020-12, så innehållet i begäranden och svar i en API-beskrivning beskrivs i\nJSON Schema med några få tillägg. MCP, protokollet som AI-agenter hittar och\nanropar verktyg genom, beskriver varje verktygs parametrar med ett\n`inputSchema`, som är ett JSON Schema, och kan beskriva resultatet med ett\n`outputSchema`, som klienter bör validera strukturerade resultat mot. En gemensam beskrivning kan alltså ligga till grund för en validator, ett API-dokument och en agent.\n\n## Så ser det ut i praktiken\n\nSchemat nedan beskriver indata till ett verktyg som bokar ett leveransfönster.\nDet anger versionen det är skrivet i, räknar upp fyra egenskaper med deras\nregler, säger vilka tre som måste finnas med och avvisar varje egenskap som det\ninte räknar upp:\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\": \"Boka ett leveransfönster\",\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 mot reglerna:\n\n```json\n{ \"order\": \"4471\", \"date\": \"27/10/2026\", \"pallets\": 0, \"pallet\": 2 }\n```\n\nInstansen fallerar på två punkter. `pallets` ligger under minimivärdet 1, och\n`pallet`, ett stavfel för `pallets`, är en egenskap som schemat inte räknar upp.\nAtt `note` saknas är inget fel, eftersom `note` inte står i `required`; hade den\nskickats som `null` hade det också gått igenom, eftersom typen tillåter null.\nDatumet är det lärorika. Formatet `date` kräver året först, och `27/10/2026` är\ninte skrivet så, men en validator som körs med sina standardinställningar godtar\ndet, eftersom specifikationen gör `format` till en annotering som bara\nkontrolleras när den kontrollen är påslagen. Slå på kontrollen i en validator\nsom kan kontrollera datum, så fallerar samma instans på tre punkter.\n\nEtt verktyg som beskrivs på det sättet är just ämnet för sidan om\n[din programvara som verktyg för AI-agenter](/sv/ai-tools/) här på webbplatsen.\nDen beskriver hur varje operation som en agent ska ha erbjuds som ett verktyg\nnamngivet efter arbetet, som att boka en tid eller släppa en order, med typade\nindata, fel som en agent kan agera på och idempotenta anrop, så att ett nytt\nförsök aldrig bokar två gånger. Beskrivningen är ett OpenAPI-dokument som\ngenereras ur koden, och en MCP-server erbjuder samma operationer. Sidans poäng\när att en agent litar på ett verktygs beskrivning även när den har blivit\ninaktuell, och en handskriven beskrivning kan glida isär från implementationen. Därför genereras beskrivningarna från koden och utåt, genom\ndatabasen, API:et, beskrivningen och klienten, med en kontroll i varje steg som\nstoppar bygget när två av dem är oense.\n\n## Var det går fel\n\n**En egenskap som räknas upp men aldrig krävs.** `properties` kontrollerar bara\nde egenskaper som finns med, så ett objekt som utelämnar dem allihop går igenom.\nAtt en egenskap måste finnas med styrs av ett eget nyckelord, och utelämnas\n`required` krävs ingenting. Skriv `required` bredvid `properties` varje gång,\noch ha ett testfall för varje obligatorisk egenskap där just den egenskapen har\ntagits bort.\n\n**Stavfel som slinker igenom som extra egenskaper.** Utan `additionalProperties`\när varje egenskap som schemat inte räknar upp tillåten, så `pallet` går igenom,\noch den riktiga `pallets` saknas utan att någon märker det. Sätts nyckelordet\ntill `false` stängs objektet, men nyckelordet ser bara `properties` och\n`patternProperties` i sitt eget schemaobjekt. Ett schema som bygger på ett annat\ngenom `allOf` eller `$ref` och sedan stänger sig självt på det sättet avvisar\njust de egenskaper som det har ärvt. Version 2020-12 har `unevaluatedProperties`\nför det fallet, eftersom det också räknar med de egenskaper som har\nkontrollerats genom `allOf`, `$ref` och de andra nyckelord som tillämpar scheman\npå plats. Använd `additionalProperties: false` på ett schema som står för sig\nsjälvt och `unevaluatedProperties: false` på ett som är sammansatt.\n\n**`format` som inte kontrollerar något.** Som standard är `format` en annotering\nsom bara beskriver, inte en valideringsregel som kan avvisa data: specifikationen kräver att\nen validator som kan kontrollera format håller den kontrollen avslagen om ingen\nber om den, och även när den är påslagen får en validator låta vilket format som\nhelst passera okontrollerat. OpenAPI 3.1 följer samma regel och tillägger att\nhur väl format kontrolleras varierar mellan implementationer. Slå på\nformatkontroll i den validator du använder, bevisa det med ett testfall som ska\nfallera, och där ett format spelar roll men inte kan kontrolleras, lägg till ett\n`pattern` eller en kontroll i koden.\n\n**Mönster som matchar en del av ett värde.** Ett `pattern` är inte förankrat, så\n`[0-9]{4}` godtar `order 4471b`, eftersom fyra siffror förekommer någonstans i\nvärdet; specifikationens eget exempel är att `es` matchar `expression`. Börja\nmönstret med `^` och avsluta det med `$` när hela värdet ska matcha. Mönster\nföljer ECMA-262-dialekten, och specifikationen rekommenderar en liten\nuppsättning konstruktioner för mönster som ska bete sig likadant överallt, så\nhåll dig till enkla teckenklasser, kvantifierare och ankare.\n\n**Saknad, null och tom behandlade som samma sak.** En egenskap som inte finns\nmed, en egenskap satt till `null` och en tom textsträng är tre olika instanser.\n`\"type\": \"string\"` avvisar `null`, och en egenskap som inte står i `required`\nfår saknas. En klient som skickar `null` för att säga ”inget värde” till ett\nschema som är skrivet med tanke på att fältet saknas fallerar på varje sådan\nbegäran. Bestäm för varje egenskap vad var och en av de tre betyder, och skriv\nner det: `[\"string\", \"null\"]` när null har en betydelse, utelämnande ur\n`required` när egenskapen är valfri och `minLength: 1` när en tom textsträng\ninte är ett värde.\n\n**Inget `$schema`, eller två versioner blandade.** När roten i ett schema saknar\n`$schema` överlåter specifikationen beteendet åt implementationen, och varje\nvalidator använder den version som den har som standard. Versionerna skiljer sig\nåt där det spelar roll. I 2019-09 beskrev en array som gavs till `items` en\ntupel; i 2020-12 har den uppgiften flyttats till `prefixItems`, och `items` har\ntagit över rollen från `additionalItems`. Sätt `$schema` i varje rot, läs\nversionsanteckningarna när du byter version och validera varje schema mot sitt\nmetaschema i CI.\n\n## Läs mer\n\n- [JSON Schema Specification](https://json-schema.org/specification) —\n  projektets översikt över den gällande versionen, metascheman och\n  versionsanteckningarna för varje tidigare utkast.\n- [JSON Schema: A Media Type for Describing JSON Documents](https://json-schema.org/draft/2020-12/json-schema-core)\n  — Core 2020-12: hur scheman behandlas, `$schema`, `$ref` och `$defs`, och de\n  nyckelord som kombinerar scheman.\n- [JSON Schema Validation: A Vocabulary for Structural Validation of JSON](https://json-schema.org/draft/2020-12/json-schema-validation)\n  — nyckelorden för varje typ av värde, `required` och reglerna för `format`.\n- [JSON Schema 2020-12 Release Notes](https://json-schema.org/draft/2020-12/release-notes)\n  — vad som har ändrats sedan 2019-09, med `prefixItems` och `$dynamicRef` sida\n  vid sida med det de ersatte.\n- [OpenAPI Specification v3.1.1](https://spec.openapis.org/oas/v3.1.1.html) —\n  Schema Object som en övermängd av JSON Schema 2020-12, och `format` som\n  annotering som standard.\n- [Model Context Protocol: Tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)\n  — hur ett verktyg anger sina parametrar och sitt strukturerade resultat i JSON\n  Schema.\n\n\u003chttps://engineer.company/sv/glossary/json-schema/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hur ett JSON-dokument kan beskriva giltiga data, var samma beskrivning kommer till nytta, och standardinställningarna som släpper igenom fel data.","formats":{"gemtext":"https://engineer.company/sv/glossary/json-schema/index.gmi","gopher":"https://engineer.company/sv/glossary/json-schema/gophermap","html":"https://engineer.company/sv/glossary/json-schema/","json":"https://engineer.company/sv/glossary/json-schema/index.json","markdown":"https://engineer.company/sv/glossary/json-schema/index.md","pdf":"https://engineer.company/sv/glossary/json-schema/index.pdf"},"kind":"page","language":"sv","title":"Vad är JSON Schema?","url":"https://engineer.company/sv/glossary/json-schema/","version":1}