{"canonical_url":"https://engineer.company/da/glossary/rest/","content_markdown":"# REST\n\n## Hvad det er\n\nREST, en forkortelse for Representational State Transfer, er den arkitekturstil,\nRoy Fielding beskrev i kapitel 5 af sin ph.d.-afhandling fra 2000. Det er\nhverken en protokol eller en standard. Det er et sæt begrænsninger for, hvordan\nen klient, en server og mellemleddene imellem dem må interagere, og Fielding gør\nrede for, hvad hver begrænsning giver, og for de flestes vedkommende også, hvad\nden koster. RESTful er tillægsordet: strengt taget betegner det et system, der\noverholder alle begrænsningerne. I daglig tale strækkes begge ord langt videre,\ntil næsten ethvert HTTP-API, der udveksler JSON, hvad enten det overholder\nbegrænsningerne nedenfor eller ej.\n\nDet bærende begreb er ressourcen. Fielding definerer den bredt: al information,\nder kan gives et navn, kan være en ressource, for eksempel et dokument, et\nbillede, en samling af andre ressourcer, en person, ja, endda dagens vejr i en\nbestemt by. Det, der krydser netværket, er aldrig selve ressourcen, men en\nrepræsentation, en række byte plus metadata, der beskriver de byte, for eksempel\net HTML-dokument eller et JPEG-billede, og en klient handler på en ressource ved\nat sende eller modtage en repræsentation af dens nuværende eller tilsigtede\ntilstand.\n\nFielding bygger stilen op fra et tomt sæt begrænsninger og tilføjer dem én ad\ngangen. Klient-server adskiller brugergrænsefladen fra datalagringen, så de to\nkan udvikle sig hver for sig. Tilstandsløshed betyder, at hver forespørgsel\nindeholder alt, hvad der skal til for at forstå den, og ikke trækker på nogen\nkontekst gemt på serveren, så sessionstilstanden ligger helt hos klienten. Cache\nkræver, at hvert svar er mærket, eksplicit eller implicit, som cachebart eller\nej, så en klient kan genbruge et cachebart svar til en senere, tilsvarende\nforespørgsel. Ensartet grænseflade, som er beskrevet nedenfor, giver alle\nkomponenter den samme generelle grænseflade. Lagdelt system betyder, at hver\nkomponent kun ser det lag, den taler direkte med, og det giver plads til\nproxyer, gateways og firewalls imellem, uden at grænsefladerne på nogen af\nsiderne skal ændres. Kode efter behov lader en server udvide en klient ved at\nsende den scripts, den kan køre, og Fielding gør den til den eneste valgfri\nbegrænsning, fordi den mindsker synligheden.\n\nHan kalder den ensartede grænseflade det centrale træk, der adskiller REST fra\nandre netværksbaserede stilarter, og deler den op i fire begrænsninger:\nressourcer identificeres, på webben med URL'er; ressourcer manipuleres gennem\nrepræsentationer; beskeder er selvbeskrivende, så deres betydning er synlig for\nethvert mellemled; og hypermedier er motoren i applikationstilstanden, hvilket\nbetyder, at klienten bevæger sig fra én tilstand til den næste ved at vælge\nblandt de overgange, der tilbydes i de repræsentationer, den allerede har, sådan\nsom et menneske følger links i en browser.\n\n## Hvorfor det betyder noget\n\nHver begrænsning giver noget konkret til gengæld. Tilstandsløshed lader et\novervågningssystem forstå en forespørgsel uden at se ud over den, gør det\nlettere at komme sig efter delvise fejl og lader en server frigive ressourcer,\nså snart den har svaret. En cache kan fjerne nogle interaktioner helt. Lag lader\nmellemled fordele belastningen over flere netværk og maskiner og lader én cache\ni kanten af en organisation betjene alle inden for den. Og fordi den ensartede\ngrænseflade afkobler implementeringerne fra de tjenester, de leverer, kan klient\nog server hver især ændre sig, uden at den anden skal følge med i samme takt.\n\nFielding lægger lige så lidt skjul på omkostningerne. Tilstandsløshed gentager\ndata i hver forespørgsel, som en fælles kontekst på serveren ville have sparet.\nEn cache kan udlevere forældede data. Hvert lag lægger overhead og latenstid\ntil. Den ensartede grænseflade forringer effektiviteten, fordi information\nsendes i en standardiseret form frem for en, der er tilpasset en bestemt\napplikations behov. Fielding designede den til overførsel af hypermediedata i\nstore bidder, det almindelige tilfælde på webben, og siger rent ud, at den ikke\ner optimal til andre former for interaktion. Det er den grund, alternativerne\nstår på. En GraphQL-server tager imod alle forespørgsler på ét endpoint,\nidentificerer sine entiteter med noget andet end URL'er og lader klienten vælge\npræcis, hvilke felter der kommer tilbage, mens gRPC kalder metoder, der er\nerklæret i en tjenestedefinition. Hver af dem opgiver en del af den ensartede\ngrænseflade for at passe til en anden slags trafik.\n\nFor et HTTP-API følger meget af den ensartede grænseflade med fra starten. HTTP\ndefinerer allerede metoder med en aftalt betydning, statuskoder og headerfelter\ntil caching og til betingede forespørgsler. Fordi den betydning er fælles, kan\nen proxy eller cache undervejs handle på en besked uden at vide noget om det\npågældende API, og et API, der bruger delene, som de er defineret, får det\nmaskineri forærende. Et API, der giver sine klienter URL-skabeloner at udfylde i\nstedet for links at følge, opgiver hypermedie-begrænsningen, og dets klienter\nbliver bundet til serverens URL-struktur: når strukturen ændres, går de i\nstykker, og det er netop den kobling, den ensartede grænseflade findes for at\nfjerne.\n\n## Sådan ser det ud i praksis\n\nUdvekslingen nedenfor opretter en ordre og får som svar adressen på den nye\nressource i `Location` og et entity tag i `ETag`. RFC 9110 bruger selv et `ETag`\ni et 201-svar som eksempel: mærket kan bruges som validator i senere betingede\nforespørgsler, så to klienter ikke i det stille kan overskrive hinandens\nændringer.\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 mellemled kan regne med. RFC 9110\ndefinerer GET, HEAD, OPTIONS og TRACE som sikre: klienten hverken beder om eller\nforventer nogen ændring af tilstanden på serveren. PUT og DELETE er sammen med\nde sikre metoder idempotente, så flere ens forespørgsler har den samme\ntilsigtede virkning som én. POST er ingen af delene, og RFC 5789 siger det samme\nom PATCH. Det er de to egenskaber, der lader en crawler følge links uden at gøre\nskade, lader en cache hente på forhånd og lader en klient sende en PUT igen, når\nforbindelsen røg, før svaret nåede frem.\n\nEt REST-API kan styres med intet andet end en generisk HTTP-klient, og her på\nsitet ses både, hvad det sparer, og hvad det koster. Da en ekstra server blev\nsat op fra kode,\n[blev begge udbyderes firewalls konfigureret direkte gennem deres REST-API'er med en generisk HTTP-opgave](/da/portfolio/provisioned-a-second-server-from-code/)\ni stedet for gennem en collection fra leverandøren. Det fjerner en afhængighed\nog de versionsafvigelser, den fører med sig, og prisen er, at hver request skal\nskrives i hånden. Samme side nævner en anden pris: den generiske HTTP-opgave\nerklærer ingen understøttelse af check-tilstand, så en prøvekørsel af det play,\nder opretter maskinen, springer alle opgaver i det over.\n\n## Hvor det går galt\n\n**En GET ændrer noget.** En adresse som `/orders/7421/cancel`, der annullerer en\nordre, når den hentes, bryder løftet om, at GET er sikker. RFC 9110 forklarer,\nhvorfor det løfte findes: så crawlere og caches, der henter på forhånd, kan\narbejde uden frygt for at gøre skade. Den første crawler eller forudhentende\ncache, der støder på linket, annullerer ordren. Læg i stedet handlingen i\nmetoden, som en POST til ordren eller en PATCH af dens status.\n\n**Hvert svar er 200 OK.** Nogle API'er returnerer 200 for alting og lægger det\negentlige udfald, fejl eller ej, i brødteksten. Beskederne holder op med at være\nselvbeskrivende: caches, proxyer, overvågning og klientbiblioteker læser alle\nstatuskoden, og de ser alle sammen succes. RFC 9457 definerer en standardiseret\nbrødtekst til fejl, `application/problem+json`, med medlemmer som `type`,\n`title`, `status` og `detail`. Dens `status`-medlem er kun vejledende: serveren\nskal sende den samme statuskode i selve HTTP-svaret, så generisk HTTP-software,\nder intet kender til formatet, opfører sig korrekt.\n\n**En gentaget POST opretter to ordrer.** Når en forbindelse ryger, efter at\nserveren har behandlet en POST, men før klienten har læst svaret, kan klienten\nikke vide, om ordren findes. RFC 9110 siger, at en klient ikke bør gentage en\nikke-idempotent forespørgsel automatisk, medmindre den ved, at forespørgslen\nalligevel er idempotent, eller kan se, at det første forsøg aldrig blev udført,\nog at en proxy slet ikke må gøre det. Den bemærker også, at nogle klienter\nvælger den mere risikable vej og alligevel gentager en POST, når forbindelsen\nlukkes, før noget af svaret er nået frem, især på en vedvarende forbindelse, der\nhar stået ubrugt hen. En udvej er at lade klienten vælge identifikatoren og\nsende ordren dertil med PUT, fordi PUT er idempotent: den første forespørgsel\nopretter ordren med 201, og en gentagelse erstatter den blot med den samme\ntilstand.\n\n**To klienter overskriver hinanden.** Begge læser ordren, begge ændrer hvert sit\nfelt, og begge sender det hele tilbage med PUT: den anden skrivning annullerer i\ndet stille den første. RFC 9110 kalder det lost update-problemet. Løsningen er\ndet entity tag, hver klient fik, da den læste ordren, sendt tilbage i\n`If-Match`. Serveren udfører så kun ændringen, hvis ressourcen stadig er i den\ntilstand, klienten sidst så; er den ikke det, må serveren ikke udføre den og kan\nsige det med 412 Precondition Failed. Klienten læser derefter ordren igen,\nlægger sin ændring ind på ny 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, der gemmer tilstand pr. klient mellem\nforespørgsler, for eksempel den aktuelle side i en liste eller en halvt udfyldt\nformular i hukommelsen, har opgivet tilstandsløsheden. En forespørgsel giver\nikke længere mening alene, load balanceren skal sende hver klient tilbage til\nden samme maskine, og en genstart smider tilstanden væk. Fieldings grunde til\ntilstandsløshed er præcis dem, der går tabt: synlighed, lettere genopretning\nefter delvise fejl og en server, der kan frigive ressourcer, når den har svaret.\nLæg tilstanden i forespørgslen, som et sidetoken i URL'en, eller gør den\nhalvfærdige ting til en ressource for sig, for eksempel en ordrekladde, som\nenhver server kan læse.\n\n## Læs mere\n\n- [Fielding, chapter 5: Representational State Transfer (REST)](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)\n  — definitionen: hver begrænsning, de egenskaber, den giver, og hvad den ofrer\n  for dem.\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) —\n  metoderne, hvilke af dem der er sikre og idempotente, statuskoderne og\n  betingede forespørgsler med `ETag` og `If-Match`.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) —\n  delvis ændring af en ressource, og hvorfor PATCH hverken er sikker eller\n  idempotent.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457)\n  — en standardiseret JSON-brødtekst til fejlsvar, der bevarer statuskodens\n  betydning.\n\n\u003chttps://engineer.company/da/glossary/rest/\u003e\n","date_modified":"2026-10-29T11:17:41Z","description":"De begrænsninger, Roy Fielding opstillede for webben, hvad de giver, hvad de koster, og fem måder, et HTTP-API, der kalder sig REST, går galt på.","formats":{"gemtext":"https://engineer.company/da/glossary/rest/index.gmi","gopher":"https://engineer.company/da/glossary/rest/gophermap","html":"https://engineer.company/da/glossary/rest/","json":"https://engineer.company/da/glossary/rest/index.json","markdown":"https://engineer.company/da/glossary/rest/index.md","pdf":"https://engineer.company/da/glossary/rest/index.pdf"},"kind":"page","language":"da","title":"Hvad er REST?","url":"https://engineer.company/da/glossary/rest/","version":1}