{"canonical_url":"https://engineer.company/sv/glossary/rest/","content_markdown":"# REST\n\n## Vad det är\n\nREST, en förkortning av Representational State Transfer, är den arkitekturstil\nsom Roy Fielding beskrev i kapitel 5 av sin doktorsavhandling från 2000. Det är\nvarken ett protokoll eller en standard. Det är en uppsättning begränsningar för\nhur en klient, en server och mellanleden mellan dem får interagera, och Fielding\nredogör för vad varje begränsning ger och, för de flesta av dem, vad den kostar.\nRESTful är adjektivet: strikt sett betecknar det ett system som följer alla\nbegränsningarna. I vardagligt tal tänjs båda orden mycket längre, till nästan\nvilket HTTP-API som helst som utbyter JSON, vare sig det följer begränsningarna\nnedan eller inte.\n\nDet bärande begreppet är resursen. Fielding definierar den brett: all\ninformation som kan ges ett namn kan vara en resurs, till exempel ett dokument,\nen bild, en samling andra resurser, en person, ja, till och med dagens väder i\nen viss stad. Det som korsar nätverket är aldrig själva resursen utan en\nrepresentation, en sekvens av byte plus metadata som beskriver dessa byte, till\nexempel ett HTML-dokument eller en JPEG-bild, och en klient agerar på en resurs\ngenom att skicka eller ta emot en representation av dess nuvarande eller avsedda\ntillstånd.\n\nFielding bygger upp stilen från en tom mängd begränsningar och lägger till dem\nen i taget. Klient-server skiljer användargränssnittet från datalagringen, så\natt de två kan utvecklas var för sig. Tillståndslöshet innebär att varje\nförfrågan innehåller allt som behövs för att förstå den och inte lutar sig mot\nnågot sammanhang som sparats på servern, så att sessionstillståndet ligger helt\nhos klienten. Cache kräver att varje svar är märkt, uttryckligen eller\nunderförstått, som cachebart eller inte, så att en klient kan återanvända ett\ncachebart svar för en senare, likvärdig förfrågan. Enhetligt gränssnitt, som\nbeskrivs nedan, ger alla komponenter samma generella gränssnitt. Skiktat system\ninnebär att varje komponent bara ser det skikt den talar direkt med, vilket ger\nutrymme för proxyer, gatewayer och brandväggar emellan utan att gränssnitten på\nnågon av sidorna behöver ändras. Kod på begäran låter en server utöka en klient\ngenom att skicka skript som den kan köra, och Fielding gör den till den enda\nvalfria begränsningen eftersom den minskar synligheten.\n\nHan kallar det enhetliga gränssnittet det centrala drag som skiljer REST från\nandra nätverksbaserade stilar och delar upp det i fyra begränsningar: resurser\nidentifieras, på webben med URL:er; resurser hanteras genom representationer;\nmeddelanden är självbeskrivande, så att deras betydelse syns för varje\nmellanled; och hypermedia är motorn i applikationstillståndet, vilket betyder\natt klienten går från ett tillstånd till nästa genom att välja bland de\növergångar som erbjuds i de representationer den redan har, på samma sätt som en\nmänniska följer länkar i en webbläsare.\n\n## Varför det spelar roll\n\nVarje begränsning ger något konkret tillbaka. Tillståndslöshet låter ett\növervakningssystem förstå en förfrågan utan att se längre än till den, gör det\nlättare att återhämta sig efter partiella fel och låter en server frigöra\nresurser så snart den har svarat. En cache kan ta bort vissa interaktioner helt.\nSkikt låter mellanled fördela lasten över nätverk och maskiner och låter en enda\ncache i utkanten av en organisation betjäna alla innanför. Och eftersom det\nenhetliga gränssnittet frikopplar implementationerna från de tjänster de\nlevererar kan klient och server ändras var för sig, utan att den andra behöver\nhänga med i samma takt.\n\nFielding är lika öppen med kostnaderna. Tillståndslöshet upprepar i varje\nförfrågan data som ett gemensamt sammanhang på servern hade sparat. En cache kan\nlämna ut inaktuella data. Varje skikt lägger till overhead och latens. Det\nenhetliga gränssnittet försämrar effektiviteten, eftersom informationen överförs\ni en standardiserad form i stället för en som är skräddarsydd efter ett visst\nprograms behov. Fielding utformade det för överföring av hypermediadata i stora\nstycken, det vanliga fallet på webben, och säger rakt ut att det inte är\noptimalt för andra slags interaktion. Det är den grunden alternativen står på.\nEn GraphQL-server tar emot alla förfrågningar på en enda slutpunkt, identifierar\nsina entiteter med något annat än URL:er och låter klienten välja exakt vilka\nfält som kommer tillbaka, medan gRPC anropar metoder som deklareras i en\ntjänstedefinition. Var och en av dem ger upp en del av det enhetliga\ngränssnittet för att passa en annan sorts trafik.\n\nFör ett HTTP-API kommer mycket av det enhetliga gränssnittet på köpet. HTTP\ndefinierar redan metoder med överenskommen betydelse, statuskoder och huvudfält\nför cachning och för villkorliga förfrågningar. Eftersom betydelsen är gemensam\nkan en proxy eller cache på vägen agera på ett meddelande utan att veta något om\ndet specifika API:et, och ett API som använder delarna så som de är definierade\nfår det maskineriet gratis. Ett API som ger sina klienter URL-mallar att fylla\ni, snarare än länkar att följa, ger upp hypermediabegränsningen, och klienterna\nblir bundna till serverns URL-struktur: när strukturen ändras går de sönder, och\ndet är just den kopplingen som det enhetliga gränssnittet finns till för att ta\nbort.\n\n## Så ser det ut i praktiken\n\nUtbytet nedan skapar en order och får som svar den nya resursens adress i\n`Location` och en entity tag i `ETag`. RFC 9110 använder själv en `ETag` i ett\n201-svar som exempel: taggen kan fungera som validator i senare villkorliga\nförfrågningar, så att två klienter inte i tysthet kan skriva över varandras\nändringar.\n\n```http\nPOST /orders HTTP/1.1\nHost: api.example.com\nContent-Type: application/json\n\n{\"item\": \"notebook\", \"quantity\": 2}\n\nHTTP/1.1 201 Created\nLocation: /orders/7421\nETag: \"v1\"\nContent-Type: application/json\n\n{\"id\": 7421, \"item\": \"notebook\", \"quantity\": 2, \"status\": \"open\"}\n```\n\nVarje metod har en betydelse som alla mellanled kan lita på. RFC 9110 definierar\nGET, HEAD, OPTIONS och TRACE som säkra: klienten varken begär eller förväntar\nsig någon ändring av tillståndet på servern. PUT och DELETE är, liksom de säkra\nmetoderna, idempotenta, så att flera identiska förfrågningar har samma avsedda\neffekt som en. POST är ingetdera, och RFC 5789 säger samma sak om PATCH. Det är\nde två egenskaperna som låter en sökrobot följa länkar utan att ställa till\nskada, låter en cache hämta i förväg och låter en klient skicka om en PUT vars\nanslutning bröts innan svaret kom fram.\n\nEtt REST-API kan styras med inget annat än en generisk HTTP-klient, och här på\nwebbplatsen syns både vad det sparar och vad det kostar. När en andra server\nprovisionerades från kod,\n[skrevs båda leverantörernas brandväggar direkt mot deras REST-API:er genom en generisk HTTP-task](/sv/portfolio/provisioned-a-second-server-from-code/)\ni stället för genom en collection från leverantören. Det tar bort ett beroende\noch dess versionsglidning, och priset är att förfrågningarnas form skrivs för\nhand. Samma sida nämner ett andra pris: den generiska HTTP-tasken deklarerar\ninget stöd för check mode, så en torrkörning av den play som skapar maskinen\nhoppar över varje task i den.\n\n## Var det går fel\n\n**En GET ändrar något.** En adress som `/orders/7421/cancel`, som avbeställer en\norder när den hämtas, bryter löftet om att GET är säker. RFC 9110 förklarar\nvarför det löftet finns: för att sökrobotar och cachar som hämtar i förväg ska\nkunna arbeta utan att behöva oroa sig för att ställa till skada. Den första\nsökrobot eller förhämtande cache som stöter på länken avbeställer ordern. Lägg i\nstället handlingen i metoden, som en POST till ordern eller en PATCH av dess\nstatus.\n\n**Varje svar är 200 OK.** Vissa API:er returnerar 200 för allt och lägger det\nverkliga utfallet, fel eller inte, i meddelandekroppen. Meddelandena slutar vara\nsjälvbeskrivande: cachar, proxyer, övervakning och klientbibliotek läser alla\nstatuskoden, och samtliga ser framgång. RFC 9457 definierar en standardiserad\nkropp för fel, `application/problem+json`, med medlemmar som `type`, `title`,\n`status` och `detail`. Dess `status`-medlem är bara rådgivande: servern måste\nskicka samma statuskod i själva HTTP-svaret, så att generisk HTTP-programvara\nsom inte känner till formatet beter sig korrekt.\n\n**En upprepad POST skapar två ordrar.** När en anslutning bryts efter att\nservern har behandlat en POST men innan klienten har läst svaret kan klienten\ninte veta om ordern finns. RFC 9110 säger att en klient inte bör upprepa en\nicke-idempotent förfrågan automatiskt, såvida den inte vet att förfrågan ändå är\nidempotent eller kan avgöra att det första försöket aldrig utfördes, och att en\nproxy inte får göra det alls. Den noterar också att vissa klienter väljer den\nmer riskfyllda vägen och ändå upprepar en POST när anslutningen stängs innan\nnågot av svaret har kommit fram, särskilt på en beständig anslutning som har\nstått oanvänd. En utväg är att låta klienten välja identifieraren och skicka\nordern dit med PUT, eftersom PUT är idempotent: den första förfrågan skapar\nordern med 201, och en upprepning ersätter den bara med samma tillstånd.\n\n**Två klienter skriver över varandra.** Båda läser ordern, båda ändrar var sitt\nfält, och båda skickar tillbaka alltihop med PUT: den andra skrivningen gör i\ntysthet den första ogjord. RFC 9110 kallar det lost update-problemet. Lösningen\när den entity tag som varje klient fick när den läste ordern, skickad tillbaka i\n`If-Match`. Servern utför då ändringen bara om resursen fortfarande är i det\ntillstånd som klienten senast såg; är den inte det får servern inte utföra den\noch kan säga det med 412 Precondition Failed. Klienten läser sedan ordern igen,\ngör om sin ändring och försöker en gång till.\n\n```http\nPUT /orders/7421 HTTP/1.1\nHost: api.example.com\nIf-Match: \"v1\"\nContent-Type: application/json\n\n{\"item\": \"notebook\", \"quantity\": 3, \"status\": \"open\"}\n\nHTTP/1.1 412 Precondition Failed\n```\n\n**Servern minns samtalet.** En server som håller tillstånd per klient mellan\nförfrågningar, till exempel den aktuella sidan i en lista eller ett halvifyllt\nformulär i minnet, har gett upp tillståndslösheten. En förfrågan går inte längre\natt förstå på egen hand, lastbalanseraren måste skicka varje klient tillbaka\ntill samma maskin, och en omstart kastar bort tillståndet. Fieldings skäl för\ntillståndslöshet är precis de som går förlorade: synlighet, enklare återhämtning\nefter partiella fel och en server som kan frigöra resurser när den har svarat.\nLägg tillståndet i förfrågan, som en sidtoken i URL:en, eller gör det\nhalvfärdiga till en egen resurs, till exempel ett orderutkast, som vilken server\nsom helst kan läsa.\n\n## Läs mer\n\n- [Fielding, chapter 5: Representational State Transfer (REST)](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)\n  — definitionen: varje begränsning, de egenskaper den ger och vad den offrar\n  för dem.\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) —\n  metoderna, vilka av dem som är säkra och idempotenta, statuskoderna och\n  villkorliga förfrågningar med `ETag` och `If-Match`.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) —\n  partiell ändring av en resurs, och varför PATCH varken är säker eller\n  idempotent.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457)\n  — en standardiserad JSON-kropp för felsvar som behåller statuskodens\n  betydelse.\n\n\u003chttps://engineer.company/sv/glossary/rest/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Begränsningarna som Roy Fielding ställde upp för webben, vad de ger, vad de kostar och fem sätt som ett HTTP-API som kallar sig REST kan gå fel på.","formats":{"gemtext":"https://engineer.company/sv/glossary/rest/index.gmi","gopher":"https://engineer.company/sv/glossary/rest/gophermap","html":"https://engineer.company/sv/glossary/rest/","json":"https://engineer.company/sv/glossary/rest/index.json","markdown":"https://engineer.company/sv/glossary/rest/index.md","pdf":"https://engineer.company/sv/glossary/rest/index.pdf"},"kind":"page","language":"sv","title":"Vad är REST?","url":"https://engineer.company/sv/glossary/rest/","version":1}