{"canonical_url":"https://engineer.company/sv/glossary/api/","content_markdown":"# API\n\n## Vad det är\n\nAPI, förkortning för application programming interface, är den publicerade uppsättning operationer\nsom ett program erbjuder andra program: vad varje operation heter, vad den tar emot, vad den\nreturnerar och hur den rapporterar problem. I bestämd form heter det API:et och i plural API:er. Den\nsom anropar lär sig den ytan och ingenting bakom den, så programmet på andra sidan kan skrivas om,\nflyttas till en annan maskin eller delas upp i tre, och anroparen fortsätter att fungera så länge\nytan håller.\n\nOrdet täcker flera skikt. Ett biblioteks API är de funktioner och typer som det exporterar, och de\nanropas inuti en och samma process. Ett operativsystems API är dess systemanrop, och POSIX\nstandardiserar en gemensam kärna av dem, så att ett program som skrivs mot `open` och `read` går att\nbygga på mer än en Unix-liknande systemkärna. Ett webb-API erbjuds över ett nätverk, nästan alltid\növer HTTP, och det är vad de flesta menar med ordet i dag: en server som besvarar förfrågningar på\nadresser som `/v1/orders`, oftast med JSON i kroppen.\n\nWebb-API:er finns i en handfull stilar. De resursorienterade, ofta kallade REST-liknande, ger varje\nsak en adress och använder HTTP:s metoder för att läsa och ändra den. De RPC-liknande, som gRPC,\npublicerar namngivna procedurer vars argument och resultat deklareras i förväg. GraphQL erbjuder en\nenda endpoint och ett schema, och klienten skriver en fråga som namnger exakt de fält den vill ha\ntillbaka. Webhooks vänder på riktningen: när något händer anropar leverantören en adress som kunden\nhar registrerat.\n\nTre närliggande ord blandas ofta ihop med API. Ett nätverksprotokoll, som HTTP, bestämmer hur\nmeddelanden färdas, medan ett API är det som en viss tjänst säger med hjälp av protokollet. Ett SDK\när ett bibliotek i ett visst programspråk som kapslar in någons API, så att en utvecklare anropar en\nfunktion i stället för att sätta ihop förfrågningar själv. Och implementationen är koden bakom\nAPI:et, som den som anropar aldrig behöver läsa.\n\n## Varför det spelar roll\n\nEtt API är den del av ett system som andra bygger vidare på, och det gör det till ett löfte som\nlever längre än koden bakom det. Att skriva om en handler tar en eftermiddag. Att ändra vad samma\nhandler returnerar kan få en app som redan är installerad i kundernas telefoner att sluta fungera,\nliksom en partners nattliga import eller ett skript som ingen längre minns att någon skrev.\n\nDet första beslutet handlar därför om publiken. Ett privat API, som bara teamets egen frontend\nanvänder, kan ändras i samma pull request som sin enda klient. Ett publikt API ändras genom\nutfasning och förvarning, och varje fält som det levererar är ett fält att stödja så länge någon\nläser det.\n\nDet andra beslutet gäller hur strikt kontraktet är. Ett strikt API deklarerar en typ och en gräns\nför varje indatavärde, avvisar det som det inte känner igen och besvarar varje misslyckande med en exakt\nstatuskod. Det fångar misstag vid dörren och är lättare att dokumentera, testa och generera klienter\nför. Ett tillåtande API tar emot vad som än kommer och gör sitt bästa, vilket känns vänligt den\nförsta månaden och sedan gör varje tillfällighet i implementationen till ett beteende som någon är\nberoende av. Stränghet kostar designtid i början. Det tillåtande kostar mer senare, vid en tidpunkt\nsom ingen själv väljer.\n\nDet tredje beslutet gäller andras API:er. En betaltjänst, en karttjänst eller en språkmodell är ett\nAPI som produkten anropar men inte styr över: priser ändras, versioner pensioneras och kvoter\nstramas åt. Den som anropar en leverantör direkt från femtio ställen i koden gör ett byte av\nleverantör till en omskrivning. Den som anropar den från en enda modul som teamet äger gör bytet\ntill en ändring i den modulen. Omslaget kostar lite indirektion och köper en väg ut.\n\nSemantic Versioning ger löftet ett ordförråd: huvudversionen räknas upp när det publika API:et\nändras på ett sätt som inte är bakåtkompatibelt, så att en klient kan avgöra enbart utifrån\nversionsnumret om en uppgradering är säker. Över HTTP finns flera ställen där ett sådant brott kan\nsignaleras, och RFC 9205, IETF:s vägledning för protokoll som byggs ovanpå HTTP, räknar bl.a. upp en\nny länkrelation, en ny medietyp och ett nytt header-fält.\n\n## Så ser det ut i praktiken\n\nAPI:erna bakom flera projekt på den här webbplatsen formades av en och samma fråga: vad hör hemma i\nAPI:et, och vad hör hemma någon annanstans?\n\nPå NextMariner, en maritim plattform för professionellt nätverkande,\nföretagsrecensioner och sponsrad utbildning, ingick det i grundarens\narkitekturbidrag att [hålla Go-API:et medvetet\ntunt](/sv/portfolio/a-maritime-platform-built-in-clean-layers/). Det är byggt\nmed Huma ovanpå Fiber, och det routar, validerar förfrågan, tillämpar\nsäkerhetsfiltreringen och orkestrerar, men innehåller ingen affärslogik alls.\nReglerna ligger i PostgreSQL-funktioner, så när en regel ändras sker det i ett\nlager, i SQL. Gränserna skrevs ned och upprätthölls i granskningen. Det gör\nAPI:et till en tråkig adapter, i ordets goda bemärkelse.\n\nEtt närliggande projekt flyttade även formningen av svaren ut ur API:et.\n[PostgreSQL-funktioner sätter ihop varje svar som JSON](/sv/portfolio/designed-a-json-passthrough-from-postgres-to-api/),\noch Go-handlern tar emot det som `json.RawMessage` och vidarebefordrar det orört, genom en liten\nhjälpfunktion som heter `QueryJSON`. DTO:erna, mappningsfunktionerna och svars-structarna som ett\nlagerindelat API brukar samla på sig föll bort, handlerkoden blev dramatiskt kortare och frontenden\nslutade vara kopplad till Go. Avvägningen är värd att nämna: formen på API:ets svar definieras nu i\nSQL, och det är där en granskare läser kontraktet.\n\nEtt API som vem som helst kan nå måste också kunna försvara sig. En publik katalog över företag och\nyrkespersoner skyddas av\n[22 anropsbegränsare, var och en byggd för den väg den skyddar](/sv/portfolio/built-fail-closed-rate-limiting-and-anti-abuse/),\nmed sitt tillstånd i Redis så att en gräns delas mellan instanser. När Redis inte går att nå\nstänger begränsarna vid fel och nekar trafiken. Cloudflare Turnstile, ett ursprungslås, en\nspecialbyggd utmaning på själva katalogen och 351 rader middleware för idempotens, som hindrar att\nen skrivning som görs om landar två gånger, fullbordar försvaret. Sidan anger kostnaden rakt ut: ett\nRedis-problem blir ett problem som användarna ser, och det valdes hellre än att ett Redis-problem\nblir ett faktureringsproblem.\n\n## Var det går fel\n\nEtt API går oftast sönder sent, när klienterna och datan väl har vuxit.\n\n**Ett omdöpt fält slår ut en klient som ingen kände till.** När ett API väl är publicerat är någon\nberoende av varje detalj som går att observera: fältnamn, ordningen i en lista, formuleringen i ett\nfelmeddelande. Döp om `customer_name` till `name`, så slutar en partners integration att fungera vid\nnästa förfrågan. Ändra genom tillägg i stället: lägg det nya fältet bredvid det gamla, markera det\ngamla för utfasning, följ loggarna tills ingen läser det och ta bort det först i en ny huvudversion.\n\n**En list-endpoint blir långsammare för varje månad.** Den returnerar varje matchande rad, vilket\ngick bra med femtio poster vid lanseringen och ger timeout vid tvåhundratusen. Paginera från första\nversionen, med en standardstorlek på sidan och ett hårt maximum som klienten inte kan gå över. För\nstora eller livligt använda samlingar är en markör (cursor) bättre än en förskjutning (offset): med\nen förskjutning puttar en rad som infogas mellan två förfrågningar en annan rad till nästa sida, där\nklienten läser den två gånger.\n\n```http\nGET /v1/orders?limit=50\u0026after=ord_8f2c HTTP/1.1\nHost: api.example.com\n```\n\n**En kund läser en annan kunds order.** API:et kontrollerar att anroparen är inloggad och hämtar\nsedan `/v1/orders/42` enbart utifrån identifieraren, så den som ändrar numret i adressen kan bläddra\ngenom andra människors data. Autentisering besvarade frågan om vem som anropar, men ingenting\nfrågade om just den anroparen äger order 42. Avgränsa varje uppslag efter ägare i själva\ndatabasfrågan, och behåll ett test som loggar in som ett konto och begär ett annat kontos poster.\n\n**Svaret bär kolumner som ingen tänkte publicera.** En endpoint serialiserar en rad ur databasen\neller ett ORM-objekt precis som det är, så att hashen av ett lösenord, en intern flagga eller en\nleverantörs inköpspris går ut till varje klient, och en kolumn som läggs till nästa år publiceras\nsamma dag som den skapas. Samma misstag på indatasidan låter en förfrågan sätta `role` eller\n`is_admin` bara genom att ta med fältet i kroppen. Ge varje endpoint uttryckliga typer för in- och\nutdata som räknar upp de tillåtna fälten, så att publiceringen av ett fält blir ett beslut som någon\nfattar.\n\n## Läs mer\n\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — metoderna, statuskoderna och\n  header-fälten som varje webb-API byggs av, så som IETF definierar dem.\n- [RFC 9205: Building Protocols with HTTP](https://www.rfc-editor.org/rfc/rfc9205) — aktuell bästa\n  praxis för att utforma en applikation ovanpå HTTP, bl.a. hur den kan utvecklas över tid.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457) — en\n  standardiserad JSON-form för felsvar, så att klienter tolkar varje misslyckande på samma sätt.\n- [RFC 6585: Additional HTTP Status Codes](https://www.rfc-editor.org/rfc/rfc6585) — där 429 Too\n  Many Requests definieras, tillsammans med `Retry-After` som talar om för en begränsad klient när\n  den kan försöka igen.\n- [Semantic Versioning 2.0.0](https://semver.org/) — reglerna för att signalera en API-ändring som\n  inte är bakåtkompatibel genom ett versionsnummer.\n\n\u003chttps://engineer.company/sv/glossary/api/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Vad ett API lovar de program som anropar det, hur det kan ändras utan att klienter slutar fungera, och de misstag som syns först i produktion.","formats":{"gemtext":"https://engineer.company/sv/glossary/api/index.gmi","gopher":"https://engineer.company/sv/glossary/api/gophermap","html":"https://engineer.company/sv/glossary/api/","json":"https://engineer.company/sv/glossary/api/index.json","markdown":"https://engineer.company/sv/glossary/api/index.md","pdf":"https://engineer.company/sv/glossary/api/index.pdf"},"kind":"page","language":"sv","title":"Vad är API?","url":"https://engineer.company/sv/glossary/api/","version":1}