{"canonical_url":"https://engineer.company/nb/glossary/api/","content_markdown":"# API\n\n## Hva det er\n\nAPI står for application programming interface, på norsk gjerne programmeringsgrensesnitt, og er det\npubliserte settet med operasjoner et program tilbyr andre programmer: hva hver operasjon heter, hva\nden tar imot, hva den returnerer, og hvordan den melder fra om problemer. Flertall er API-er, og\nbestemt form API-et. Den som kaller, lærer seg denne overflaten og ingenting bak den. Programmet på\nden andre siden kan derfor skrives om, flyttes til en annen maskin eller deles i tre, og den som\nkaller, fortsetter å virke så lenge overflaten holder.\n\nOrdet dekker flere lag. API-et til et bibliotek er funksjonene og typene det eksporterer, og de\nkalles inne i én prosess. API-et til et operativsystem er settet med systemkall, og POSIX\nstandardiserer et felles grunnsett av dem, så et program skrevet mot `open` og `read` kan bygges på\nmer enn én Unix-lignende systemkjerne. Et web-API tilbys over et nettverk, nesten alltid over HTTP,\nog det er det de fleste mener med ordet alene i dag: en server som svarer på forespørsler på\nadresser som `/v1/orders`, som regel med JSON i kroppen.\n\nWeb-API-er finnes i en håndfull stiler. De ressursorienterte, ofte kalt REST-stil, gir hver ting en\nadresse og bruker metodene i HTTP til å lese og endre den. RPC-stilen, f.eks. gRPC, publiserer\nnavngitte prosedyrer med argumenter og resultater deklarert på forhånd. GraphQL tilbyr ett endepunkt\nog et skjema, og klienten skriver en spørring som navngir nøyaktig de feltene den vil ha tilbake.\nWebhooks snur retningen: leverandøren kaller en adresse kunden har registrert, når noe skjer.\n\nTre nabobegreper blandes ofte sammen med det. En protokoll, som HTTP, definerer hvordan meldinger\nreiser; et API er det én bestemt tjeneste sier i den protokollen. Et SDK er et bibliotek i ett\nprogrammeringsspråk som pakker inn noens API, så en utvikler kaller en funksjon i stedet for å sette\nsammen forespørsler selv. Og implementasjonen er koden bak API-et, som den som kaller, aldri trenger\nå lese.\n\n## Hvorfor det er viktig\n\nEt API er den delen av et system andre bygger på, og det gjør det til et løfte som varer lenger enn\nkoden bak det. Å skrive om en handler tar en ettermiddag. Å endre hva den samme handleren\nreturnerer, kan ødelegge en app som allerede er installert på kundenes telefoner, en partners\nnattlige import eller et skript ingen husker å ha skrevet.\n\nDen første beslutningen handler derfor om publikum. Et privat API, som bare teamets egen frontend\nbruker, kan endres i samme pull request som den ene klienten sin. Et offentlig API endres gjennom\navvikling (deprecation) og varsel, og hvert felt det sender ut, er et felt som må støttes så lenge\nnoen leser det.\n\nDen andre beslutningen er hvor streng kontrakten skal være. Et strengt API deklarerer en type og en\ngrense for hver inndataverdi, avviser det det ikke kjenner igjen, og svarer på hver feil med en presis\nstatuskode. Det fanger feil i døra og er lettere å dokumentere, teste og generere klienter for. Et\ntolerant API godtar alt som kommer, og gjør så godt det kan. Det føles vennlig den første måneden,\nog gjør deretter hvert tilfeldig trekk ved implementasjonen til atferd noen er avhengige av.\nStrenghet koster designtid i starten; toleranse koster mer senere, på et tidspunkt ingen velger\nselv.\n\nDen tredje beslutningen gjelder andres API-er. En betalingsleverandør, en karttjeneste eller en\nspråkmodell er et API produktet kaller, men ikke kontrollerer: prisene flytter seg, versjoner\npensjoneres, kvotene strammes inn. Kaller du en leverandør direkte fra femti steder, blir et bytte\nen omskriving. Kaller du den fra én modul teamet eier, blir byttet en endring i den modulen.\nInnpakningen koster et ekstra lag og kjøper deg en vei ut.\n\nSemantic Versioning gir dette løftet et vokabular: hovedversjonsnummeret går opp når det offentlige\nAPI-et endres på en måte som ikke er kompatibel, så en klient kan se av versjonen alene om en\noppgradering er trygg. Over HTTP finnes det flere steder å signalisere et brudd, og RFC 9205, IETFs\nveiledning for protokoller bygd på HTTP, nevner bl.a. en ny lenkerelasjon, en ny medietype eller et\nnytt headerfelt.\n\n## Slik ser det ut i praksis\n\nAPI-ene bak flere prosjekter på dette nettstedet ble formet av ett spørsmål: hva hører hjemme i\nAPI-et, og hva hører hjemme et annet sted?\n\nPå NextMariner, en maritim plattform for profesjonell nettverksbygging, selskapsomtaler og sponset opplæring, omfattet grunnleggerens arkitekturbidrag [å holde Go-API-et bevisst tynt](/nb/portfolio/a-maritime-platform-built-in-clean-layers/). Det er bygd med Huma over Fiber, ruter, validerer forespørselen, anvender sikkerhetsfiltreringen og orkestrerer, og inneholder ingen forretningslogikk i det hele tatt. Reglene ligger i PostgreSQL-funksjoner, slik at en regelendring skjer i ett lag, i SQL. Grensene ble skrevet ned og håndhevet i gjennomganger. Det gjør API-et til en kjedelig adapter, i god forstand.\n\nEt beslektet prosjekt flyttet også formingen ut av API-et.\n[PostgreSQL-funksjoner setter sammen hvert svar som JSON](/nb/portfolio/designed-a-json-passthrough-from-postgres-to-api/),\nog Go-handleren tar det imot som `json.RawMessage` og videresender det urørt, gjennom en liten\n`QueryJSON`-hjelper. DTO-ene, mappingkoden og respons-structene et lagdelt API vanligvis samler opp,\nfalt bort, handlerne ble dramatisk kortere, og frontenden var ikke lenger avhengig av Go. Byttet\nfortjener å bli nevnt: formen på API-ets svar er nå definert i SQL, og det er der den som gjennomgår\nkoden, leser kontrakten.\n\nEt API alle kan nå, må også forsvare seg selv. En offentlig katalog over bedrifter og fagfolk ligger\nbak\n[22 hastighetsbegrensere, hver bygd for ruten den beskytter](/nb/portfolio/built-fail-closed-rate-limiting-and-anti-abuse/),\nmed tilstanden i Redis så en grense holder på tvers av instanser. Når Redis ikke kan nås, feiler\nbegrenserne lukket (fail closed) og avviser trafikken. Cloudflare Turnstile, en opprinnelseslås, en\nskreddersydd utfordring på katalogen og 351 linjer idempotensmellomvare, som hindrer at en skriving\nsom prøves på nytt, lander to ganger, fullfører forsvaret. Siden sier kostnaden rett ut: et\nRedis-problem blir et problem brukerne ser, og det ble foretrukket framfor at et Redis-problem blir\net faktureringsproblem.\n\n## Hvor det går galt\n\nFeil i API-er kommer gjerne sent, når klientene og dataene har vokst.\n\n**Et omdøpt felt ødelegger for en klient ingen visste om.** Så snart et API er publisert, er noen\navhengig av hver detalj som kan observeres: feltnavn, rekkefølgen i en liste, ordlyden i en\nfeilmelding. Døp om `customer_name` til `name`, og integrasjonen til en partner brekker på neste\nforespørsel. Endre heller ved å legge til: legg det nye feltet ved siden av det gamle, merk det\ngamle for utfasing, følg med i loggene til ingen leser det, og fjern det først i en ny hovedversjon.\n\n**Et listeendepunkt blir tregere for hver måned.** Det returnerer hver rad som matcher, noe som gikk\nfint med femti poster ved lansering og gir tidsavbrudd ved to hundre tusen. Bruk paginering fra\nførste versjon, med en standard sidestørrelse og et fast maksimum klienten ikke kan overskride. For\nstore eller travle samlinger bør du velge en markør (cursor) framfor en forskyvning (offset): med en\nforskyvning skyver en rad som settes inn mellom to forespørsler, en annen rad over på neste side,\nder klienten leser den to ganger.\n\n```http\nGET /v1/orders?limit=50\u0026after=ord_8f2c HTTP/1.1\nHost: api.example.com\n```\n\n**En kunde leser en annen kundes ordre.** API-et sjekker at den som kaller, er logget inn, og laster\nderetter `/v1/orders/42` ut fra identifikatoren alene, så den som endrer tallet i adressen, kan bla\nseg gjennom andres data. Autentisering svarte på hvem som kaller, men det var aldri noen som spurte\nom den som kaller, eier ordre 42. Avgrens hvert oppslag etter eier inne i selve spørringen, og ha en\ntest som logger inn som én konto og ber om en annen kontos poster.\n\n**Svaret bærer kolonner ingen mente å publisere.** Et endepunkt serialiserer en databaserad eller et\nORM-objekt som det står, så hashen av et passord, et internt flagg eller en leverandørs innkjøpspris\ngår ut til hver klient, og en kolonne som legges til neste år, publiseres samme dag den opprettes.\nDen samme feilen på inndatasiden lar en forespørsel sette `role` eller `is_admin` ved å ta feltet\nmed i kroppen. Gi hvert endepunkt eksplisitte typer for inndata og utdata som lister opp feltene som\ner tillatt, så det å publisere et felt blir en beslutning noen tar.\n\n## Les mer\n\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110)\n  — metodene, statuskodene og headerne hvert web-API er bygd av, definert av IETF.\n- [RFC 9205: Building Protocols with HTTP](https://www.rfc-editor.org/rfc/rfc9205)\n  — gjeldende beste praksis for å utforme en protokoll oppå HTTP, også for hvordan den\n  videreutvikles.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457)\n  — en standard JSON-form for feilsvar, så klienter tolker hver feil på samme måte.\n- [RFC 6585: Additional HTTP Status Codes](https://www.rfc-editor.org/rfc/rfc6585)\n  — der 429 Too Many Requests og hintet `Retry-After` for klienter som begrenses, er definert.\n- [Semantic Versioning 2.0.0](https://semver.org/)\n  — reglene for å signalisere en inkompatibel API-endring gjennom et versjonsnummer.\n\n\u003chttps://engineer.company/nb/glossary/api/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva et API er, hvorfor formen varer lenger enn koden bak den, hvordan du endrer det uten å ødelegge for klientene, og fire feil som viser seg i produksjon.","formats":{"gemtext":"https://engineer.company/nb/glossary/api/index.gmi","gopher":"https://engineer.company/nb/glossary/api/gophermap","html":"https://engineer.company/nb/glossary/api/","json":"https://engineer.company/nb/glossary/api/index.json","markdown":"https://engineer.company/nb/glossary/api/index.md","pdf":"https://engineer.company/nb/glossary/api/index.pdf"},"kind":"page","language":"nb","title":"Hva betyr API?","url":"https://engineer.company/nb/glossary/api/","version":1}