{"canonical_url":"https://engineer.company/nb/glossary/rest/","content_markdown":"# REST\n\n## Hva det er\n\nREST, en forkortelse for Representational State Transfer, er arkitekturstilen\nRoy Fielding beskrev i kapittel 5 av doktorgradsavhandlingen sin fra 2000. Det\ner verken en protokoll eller en standard. Det er et sett begrensninger for\nhvordan en klient, en server og mellomleddene mellom dem kan samhandle, og\nFielding gjør rede for hva hver begrensning gir, og for de flestes del også hva\nden koster. RESTful er adjektivet: strengt tatt betegner det et system som\noverholder alle begrensningene. I dagligtale strekkes begge ordene mye lenger,\ntil nesten ethvert HTTP-API som utveksler JSON, enten det overholder\nbegrensningene nedenfor eller ikke.\n\nDet bærende begrepet er ressursen. Fielding definerer den vidt: all informasjon\nsom kan gis et navn, kan være en ressurs, for eksempel et dokument, et bilde, en\nsamling andre ressurser, en person, ja, til og med dagens vær i en bestemt by.\nDet som krysser nettverket, er aldri selve ressursen, men en representasjon, en\nsekvens av byte pluss metadata som beskriver de bytene, for eksempel et\nHTML-dokument eller et JPEG-bilde, og en klient handler på en ressurs ved å\nsende eller motta en representasjon av den nåværende eller tiltenkte tilstanden\ndens.\n\nFielding bygger opp stilen fra et tomt sett begrensninger og legger dem til én\nom gangen. Klient-server skiller brukergrensesnittet fra datalagringen, slik at\nde to kan utvikle seg hver for seg. Tilstandsløshet betyr at hver forespørsel\ninneholder alt som trengs for å forstå den, og ikke lener seg på noen kontekst\nlagret på serveren, slik at sesjonstilstanden ligger helt hos klienten. Cache\nkrever at hvert svar er merket, eksplisitt eller implisitt, som cachebart eller\nikke, slik at en klient kan gjenbruke et cachebart svar til en senere,\ntilsvarende forespørsel. Enhetlig grensesnitt, som er beskrevet nedenfor, gir\nalle komponenter det samme generelle grensesnittet. Lagdelt system betyr at hver\nkomponent bare ser det laget den snakker direkte med, og det gir rom for\nproxyer, gatewayer og brannmurer imellom uten at grensesnittene på noen av\nsidene må endres. Kode ved behov lar en server utvide en klient ved å sende den\nskript den kan kjøre, og Fielding gjør den til den eneste valgfrie\nbegrensningen, fordi den reduserer synligheten.\n\nHan kaller det enhetlige grensesnittet det sentrale trekket som skiller REST fra\nandre nettverksbaserte stiler, og deler det opp i fire begrensninger: ressurser\nidentifiseres, på weben med URL-er; ressurser manipuleres gjennom\nrepresentasjoner; meldinger er selvbeskrivende, slik at betydningen deres er\nsynlig for ethvert mellomledd; og hypermedier er motoren i\napplikasjonstilstanden, noe som betyr at klienten beveger seg fra én tilstand\ntil den neste ved å velge blant overgangene som tilbys i representasjonene den\nallerede har, slik et menneske følger lenker i en nettleser.\n\n## Hvorfor det er viktig\n\nHver begrensning gir noe konkret tilbake. Tilstandsløshet lar et\novervåkingssystem forstå en forespørsel uten å se ut over den, gjør det lettere\nå komme seg etter delvise feil og lar en server frigjøre ressurser så snart den\nhar svart. En cache kan fjerne noen interaksjoner helt. Lag lar mellomledd\nfordele belastningen over flere nettverk og maskiner og lar én cache i kanten av\nen organisasjon betjene alle innenfor den. Og fordi det enhetlige grensesnittet\nfrikobler implementasjonene fra tjenestene de leverer, kan klient og server hver\nfor seg endre seg uten at den andre må følge med i samme takt.\n\nFielding legger like lite skjul på kostnadene. Tilstandsløshet gjentar i hver\nforespørsel data som en felles kontekst på serveren ville ha spart. En cache kan\nlevere ut foreldede data. Hvert lag legger til overhead og latens. Det enhetlige\ngrensesnittet svekker effektiviteten, fordi informasjonen overføres i en\nstandardisert form i stedet for en som er skreddersydd for behovene i ett\nbestemt program. Fielding utformet det for overføring av hypermediedata i store\nbiter, det vanlige tilfellet på weben, og sier rett ut at det ikke er optimalt\nfor andre former for samhandling. Det er det grunnlaget alternativene står på.\nEn GraphQL-server tar imot alle forespørsler på ett endepunkt, identifiserer\nentitetene sine med noe annet enn URL-er og lar klienten velge nøyaktig hvilke\nfelt som kommer tilbake, mens gRPC kaller metoder som er deklarert i en\ntjenestedefinisjon. Hver av dem gir opp en del av det enhetlige grensesnittet\nfor å passe til en annen type trafikk.\n\nFor et HTTP-API følger mye av det enhetlige grensesnittet med fra start. HTTP\ndefinerer allerede metoder med en avtalt betydning, statuskoder og headerfelt\nfor caching og for betingede forespørsler. Fordi den betydningen er felles, kan\nen proxy eller cache underveis handle på en melding uten å vite noe om det\naktuelle API-et, og et API som bruker disse delene slik de er definert, får det\nmaskineriet gratis. Et API som gir klientene sine URL-maler å fylle ut i stedet\nfor lenker å følge, gir opp hypermediebegrensningen, og klientene blir bundet\ntil URL-strukturen på serveren: når strukturen endres, går de i stykker, og det\ner nettopp den koblingen det enhetlige grensesnittet finnes for å fjerne.\n\n## Slik ser det ut i praksis\n\nUtvekslingen nedenfor oppretter en ordre og får som svar adressen til den nye\nressursen i `Location` og en entity tag i `ETag`. RFC 9110 bruker selv en `ETag`\ni et 201-svar som eksempel: taggen kan brukes som validator i senere betingede\nforespørsler, slik at to klienter ikke i det stille kan overskrive hverandres\nendringer.\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\nHver metode har en betydning som ethvert mellomledd kan stole på. RFC 9110\ndefinerer GET, HEAD, OPTIONS og TRACE som sikre: klienten verken ber om eller\nforventer noen endring av tilstanden på serveren. PUT og DELETE er sammen med de\nsikre metodene idempotente, slik at flere like forespørsler har den samme\ntiltenkte virkningen som én. POST er ingen av delene, og RFC 5789 sier det samme\nom PATCH. Det er de to egenskapene som lar en søkerobot følge lenker uten å\ngjøre skade, lar en cache hente på forhånd og lar en klient sende en PUT på nytt\nnår forbindelsen brøt før svaret kom fram.\n\nEt REST-API kan styres med ingenting annet enn en generisk HTTP-klient, og her\npå nettstedet ser man både hva det sparer, og hva det koster. Da en server\nnummer to ble klargjort fra kode,\n[ble begge leverandørenes brannmurer skrevet direkte mot REST-API-ene deres gjennom en generisk HTTP-oppgave](/nb/portfolio/provisioned-a-second-server-from-code/)\ni stedet for gjennom en collection fra leverandøren. Det fjerner en avhengighet\nog versjonsdriften dens, og prisen er at formen på forespørslene må skrives for\nhånd. Samme side nevner en annen pris: den generiske HTTP-oppgaven deklarerer\nikke støtte for check mode, så en tørrkjøring av playet som oppretter maskinen,\nhopper over hver oppgave i det.\n\n## Hvor det går galt\n\n**En GET endrer noe.** En adresse som `/orders/7421/cancel`, som kansellerer en\nordre når den hentes, bryter løftet om at GET er sikker. RFC 9110 forklarer\nhvorfor det løftet finnes: slik at søkeroboter og cacher som henter på forhånd,\nkan arbeide uten frykt for å gjøre skade. Den første søkeroboten eller\nforhåndshentende cachen som kommer over lenken, kansellerer ordren. Legg i\nstedet handlingen i metoden, som en POST til ordren eller en PATCH av statusen\ndens.\n\n**Hvert svar er 200 OK.** Noen API-er returnerer 200 for alt og legger det\negentlige utfallet, feil eller ikke, i meldingskroppen. Meldingene slutter å\nvære selvbeskrivende: cacher, proxyer, overvåking og klientbiblioteker leser\nalle statuskoden, og samtlige ser suksess. RFC 9457 definerer en standardisert\nmeldingskropp for feil, `application/problem+json`, med medlemmer som `type`,\n`title`, `status` og `detail`. `status`-medlemmet er bare veiledende: serveren\nmå sende den samme statuskoden i selve HTTP-svaret, slik at generisk\nHTTP-programvare som ikke kjenner formatet, oppfører seg riktig.\n\n**En gjentatt POST oppretter to ordrer.** Når en forbindelse brytes etter at\nserveren har behandlet en POST, men før klienten har lest svaret, kan ikke\nklienten vite om ordren finnes. RFC 9110 sier at en klient ikke bør gjenta en\nikke-idempotent forespørsel automatisk med mindre den vet at forespørselen\nlikevel er idempotent, eller kan se at det første forsøket aldri ble utført, og\nat en proxy slett ikke får gjøre det. Den påpeker også at noen klienter velger\nden mer risikable veien og likevel gjentar en POST når forbindelsen lukkes før\nnoe av svaret er kommet fram, særlig på en vedvarende forbindelse som har stått\nubrukt. En utvei er å la klienten velge identifikatoren og sende ordren dit med\nPUT, fordi PUT er idempotent: den første forespørselen oppretter ordren med 201,\nog en gjentakelse erstatter den bare med den samme tilstanden.\n\n**To klienter overskriver hverandre.** Begge leser ordren, begge endrer hvert\nsitt felt, og begge sender det hele tilbake med PUT: den andre skrivingen\nopphever i det stille den første. RFC 9110 kaller dette lost update-problemet.\nLøsningen er entity-taggen hver klient fikk da den leste ordren, sendt tilbake i\n`If-Match`. Serveren utfører da bare endringen hvis ressursen fortsatt er i den\ntilstanden klienten sist så; er den ikke det, får serveren ikke utføre den og\nkan si fra med 412 Precondition Failed. Klienten leser deretter ordren på nytt,\nlegger inn endringen sin igjen og prøver en gang til.\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**Serveren husker samtalen.** En server som holder tilstand per klient mellom\nforespørsler, for eksempel gjeldende side i en liste eller et halvt utfylt\nwebskjema i minnet, har gitt opp tilstandsløsheten. En forespørsel gir ikke\nlenger mening alene, lastbalansereren må sende hver klient tilbake til den samme\nmaskinen, og en omstart kaster tilstanden. Fieldings grunner til tilstandsløshet\ner nettopp de som går tapt: synlighet, enklere gjenoppretting etter delvise feil\nog en server som kan frigjøre ressurser når den har svart. Legg tilstanden i\nforespørselen, som et sidetoken i URL-en, eller gjør det halvferdige til en egen\nressurs, for eksempel et ordreutkast, som enhver server kan lese.\n\n## Les mer\n\n- [Fielding, chapter 5: Representational State Transfer (REST)](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)\n  — definisjonen: hver begrensning, egenskapene den gir, og hva den ofrer for\n  dem.\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — metodene,\n  hvilke av dem som er sikre og idempotente, statuskodene og betingede\n  forespørsler med `ETag` og `If-Match`.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) —\n  delvis endring av en ressurs, og hvorfor PATCH verken er sikker eller\n  idempotent.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457)\n  — en standardisert JSON-kropp for feilsvar som bevarer betydningen av\n  statuskoden.\n\n\u003chttps://engineer.company/nb/glossary/rest/\u003e\n","date_modified":"2026-10-29T11:17:41Z","description":"Begrensningene Roy Fielding satte opp for weben, hva de gir, hva de koster, og fem måter et HTTP-API som kaller seg REST, går galt på.","formats":{"gemtext":"https://engineer.company/nb/glossary/rest/index.gmi","gopher":"https://engineer.company/nb/glossary/rest/gophermap","html":"https://engineer.company/nb/glossary/rest/","json":"https://engineer.company/nb/glossary/rest/index.json","markdown":"https://engineer.company/nb/glossary/rest/index.md","pdf":"https://engineer.company/nb/glossary/rest/index.pdf"},"kind":"page","language":"nb","title":"Hva er REST?","url":"https://engineer.company/nb/glossary/rest/","version":1}