{"canonical_url":"https://engineer.company/da/glossary/api/","content_markdown":"# API\n\n## Hvad det er\n\nEt API, en forkortelse af application programming interface, er de offentliggjorte\noperationer, et stykke software stiller til rådighed for anden software: hvad hver operation\nhedder, hvad den tager imod, hvad den svarer, og hvordan den melder om problemer. I flertal\nskrives det API'er eller APIer. Den, der kalder, kender overfladen og intet bag den, så\nprogrammet på den anden side kan skrives om, flyttes til en anden maskine eller deles i tre,\nmens kalderen bliver ved med at virke, så længe overfladen holder.\n\nOrdet dækker flere lag. Et biblioteks API er de funktioner og typer, biblioteket eksporterer,\nog de kaldes inden for én proces. Et styresystems API er dets systemkald, og POSIX\nstandardiserer et fælles sæt af dem, så et program skrevet mod `open` og `read` kan bygges til\nmere end ét Unix-lignende system. Et web-API udbydes over et netværk, næsten altid over HTTP,\nog det er det, de fleste mener med ordet i dag: en server, der svarer på forespørgsler til\nadresser som `/v1/orders`, typisk med JSON som indhold.\n\nWeb-API'er findes i en håndfuld stilarter. De ressourceorienterede, ofte kaldt REST-agtige,\ngiver hver ting sin egen adresse og bruger HTTP's metoder til at læse og ændre den. De\nRPC-agtige, som gRPC, udstiller navngivne procedurer med argumenter og resultater erklæret på\nforhånd. GraphQL har ét endpoint og et skema, og klienten skriver en forespørgsel, der nævner\npræcis de felter, den vil have tilbage. Webhooks vender retningen om: udbyderen kalder en\nadresse, kunden har registreret, når der sker noget.\n\nTre nabobegreber bliver ofte blandet sammen med det. En protokol som HTTP bestemmer, hvordan\nbeskeder bevæger sig; et API er det, en bestemt tjeneste siger i den protokol. Et SDK er et\nbibliotek i ét programmeringssprog, der pakker en andens API ind, så en udvikler kalder en\nfunktion i stedet for at bygge forespørgsler selv. Og implementeringen er koden bag API'et, som\nden, der kalder, slet ikke behøver at læse.\n\n## Hvorfor det betyder noget\n\nEt API er den del af et system, som andre bygger videre på, og derfor er det et løfte, der\nlever længere end koden bag det. At skrive en handler om tager en eftermiddag. At ændre det,\nhandleren svarer, kan knække en app, der allerede ligger på kundernes telefoner, en partners\nnatlige import eller et script, ingen længere husker at have skrevet.\n\nDen første beslutning handler derfor om publikum. Et privat API, som kun teamets egen frontend\nbruger, kan ændres i samme pull request som sin ene klient. Et offentligt API ændres gennem\nudfasning og varsel, og hvert felt, det sender ud, er et felt, der skal understøttes, så længe\nnogen læser det.\n\nDen anden beslutning er, hvor stram kontrakten skal være. Et stramt API erklærer type og\ngrænse for hvert input, afviser det, det ikke kender, og svarer på hver fejl med en præcis\nstatuskode. Det fanger fejl ved døren og er lettere at dokumentere, teste og generere klienter\ntil. Et eftergivende API tager imod hvad som helst og gør sit bedste. Det føles venligt den\nførste måned og gør siden hvert tilfældigt træk ved implementeringen til adfærd, som nogen er\nafhængig af. Stramhed koster designtid nu; eftergivenhed koster mere senere, på et tidspunkt\ningen selv vælger.\n\nDen tredje beslutning gælder andres API'er. En betalingsudbyder, en korttjeneste eller en\nsprogmodel er et API, produktet kalder uden at styre det: priserne flytter sig, versioner\nudfases, kvoter strammes. Kaldes leverandøren direkte fra halvtreds steder, bliver et skifte\ntil en omskrivning. Kaldes den fra ét modul, teamet selv ejer, bliver skiftet en ændring i det\nmodul. Indpakningen koster lidt indirektion og køber en udvej.\n\nSemantic Versioning giver løftet et ordforråd: hovednummeret stiger, når det offentlige API\nændres, så det bryder med tidligere versioner, og en klient kan derfor se på versionen alene,\nom en opgradering er sikker. Over HTTP er der flere steder at markere et brud, og RFC 9205,\nIETF's vejledning til protokoller bygget på HTTP, nævner blandt andet en ny linkrelation, en ny\nmedietype og et nyt headerfelt.\n\n## Sådan ser det ud i praksis\n\nAPI'erne bag flere af projekterne på dette site er formet af ét spørgsmål: hvad hører hjemme i\nAPI'et, og hvad hører hjemme et andet sted?\n\nPå NextMariner, en maritim platform til professionelt netværk,\nvirksomhedsanmeldelser og sponsoreret uddannelse, omfattede\ngrundlæggerens arkitekturbidrag\n[at holde Go-API'et bevidst tyndt](/da/portfolio/a-maritime-platform-built-in-clean-layers/).\nDet er bygget med Huma oven på Fiber, og det router, validerer\nforespørgslen, anvender sikkerhedsfiltreringen og orkestrerer, men\nrummer ingen forretningslogik overhovedet. Reglerne bor i\nPostgreSQL-funktioner, så en regelændring sker i ét lag, i SQL.\nGrænserne blev skrevet ned og håndhævet i review. Det gør API'et til\nen kedelig adapter i den gode betydning af ordet.\n\nEt beslægtet projekt tog også formningen af svarene ud af API'et.\n[PostgreSQL-funktioner samler hvert svar som JSON](/da/portfolio/designed-a-json-passthrough-from-postgres-to-api/),\nog Go-handleren modtager det som `json.RawMessage` og sender det uberørt videre gennem en lille\n`QueryJSON`-hjælper. De DTO'er, mappere og svarstrukturer, et lagdelt API plejer at samle op,\nfaldt bort, handlerkoden blev markant kortere, og frontenden blev koblet fri af Go. Prisen er\nværd at nævne: svarenes form er nu defineret i SQL, så det er dér, en reviewer læser\nkontrakten.\n\nEt API, som alle kan nå, må også kunne forsvare sig. Et offentligt register over virksomheder\nog fagfolk ligger bag\n[22 rate limiters, hver bygget til den sti, den beskytter](/da/portfolio/built-fail-closed-rate-limiting-and-anti-abuse/),\nmed deres tilstand i Redis, så en grænse gælder på tværs af instanser. Forsvinder Redis, fejler\nde lukket og afviser trafikken. Rundt om dem står Cloudflare Turnstile, 351 linjers middleware\ntil idempotens, så en gentaget skrivning ikke bliver til to, en oprindelseslås og en\nskræddersyet udfordring på selve registret. Prisen står der ligeud: et Redis-problem bliver et\nproblem, brugerne kan se, og det blev foretrukket frem for et Redis-problem, der ender på\nregningen.\n\n## Hvor det går galt\n\nFejl i et API viser sig typisk sent, når klienterne og datamængden er vokset.\n\n**Et omdøbt felt knækker en klient, som ingen kendte til.** Når et API først er offentliggjort,\nafhænger nogen af hver synlig detalje: feltnavne, rækkefølgen i en liste, ordlyden af en\nfejlbesked. Omdøb `customer_name` til `name`, og en partners integration knækker ved næste\nforespørgsel. Ændr i stedet ved at tilføje: læg det nye felt ved siden af det gamle, markér det\ngamle til udfasning, følg med i logfilerne, til det gamle felt står ulæst hen, og fjern det først\ni en ny hovedversion.\n\n**Et listeendpoint bliver langsommere hver måned.** Det returnerer hver eneste række, som\nforespørgslen rammer, hvilket gik fint med halvtreds poster ved lanceringen og giver timeout\nved to hundrede tusind. Paginér fra første udgivelse med en standardstørrelse pr. side og et\nhårdt loft, klienten ikke kan overskride. Til store eller travle samlinger er en cursor bedre\nend et offset: med et offset skubber en række, der indsættes mellem to forespørgsler, en anden\nrække over på næste side, hvor klienten så læser den to gange.\n\n```http\nGET /v1/orders?limit=50\u0026after=ord_8f2c HTTP/1.1\nHost: api.example.com\n```\n\n**En kunde læser en anden kundes ordre.** API'et tjekker, at den, der kalder, er logget ind, og\nhenter så `/v1/orders/42` alene ud fra id'et, så man ved at ændre tallet i adressen kan bladre\ngennem andres data. Autentificeringen svarede på, hvem der kalder; intet spurgte, om den, der\nkalder, ejer ordre 42. Afgræns hvert opslag efter ejer inde i selve forespørgslen, og hav en\ntest, der logger ind som én konto og beder om en anden kontos poster.\n\n**Svaret indeholder kolonner, som ingen havde tænkt sig at offentliggøre.** Et endpoint\nserialiserer en databaserække eller et ORM-objekt, som det står, så en hashet adgangskode, et\ninternt flag eller en leverandørs indkøbspris går ud til alle klienter, og en kolonne, der\ntilføjes næste år, offentliggøres samme dag, den oprettes. Den samme fejl på input lader en\nforespørgsel sætte `role` eller `is_admin` blot ved at have feltet med. Giv hvert endpoint\neksplicitte input- og outputtyper, der opregner de tilladte felter, så det bliver en bevidst\nbeslutning at offentliggøre et felt.\n\n## Læs mere\n\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — de metoder,\n  statuskoder og headere, som ethvert web-API er bygget af, defineret af IETF.\n- [RFC 9205: Building Protocols with HTTP](https://www.rfc-editor.org/rfc/rfc9205) — bedste\n  praksis for at designe en applikation oven på HTTP, også for hvordan den udvikler sig.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457) — en\n  standardiseret JSON-form til fejlsvar, så klienter læser hver fejl på samme måde.\n- [RFC 6585: Additional HTTP Status Codes](https://www.rfc-editor.org/rfc/rfc6585) — hvor 429\n  Too Many Requests og headeren `Retry-After` til begrænsede klienter er defineret.\n- [Semantic Versioning 2.0.0](https://semver.org/) — reglerne for at signalere en inkompatibel\n  API-ændring gennem et versionsnummer.\n\n\u003chttps://engineer.company/da/glossary/api/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvad et API er, hvorfor dets form lever længere end koden bag det, hvordan det ændres uden at knække klienter, og fire fejl, der viser sig i drift.","formats":{"gemtext":"https://engineer.company/da/glossary/api/index.gmi","gopher":"https://engineer.company/da/glossary/api/gophermap","html":"https://engineer.company/da/glossary/api/","json":"https://engineer.company/da/glossary/api/index.json","markdown":"https://engineer.company/da/glossary/api/index.md","pdf":"https://engineer.company/da/glossary/api/index.pdf"},"kind":"page","language":"da","title":"Hvad er et API?","url":"https://engineer.company/da/glossary/api/","version":1}