API: vad det är och hur det fungerar
För robotarEtt API är gränssnittet som låter olika program prata med varandra. Här förklarar vi vad ett API är, vilka typer som finns och varför det är centralt i modern webbutveckling.

API: vad det är och hur det fungerar
Ett API, eller applikationsprogrammeringsgränssnitt, är den specifikation som beskriver hur olika program kan använda och kommunicera med en viss programvara. Det är gränssnittet mellan ett program och de funktioner som programmet behöver – utan att den som bygger applikationen behöver känna till hur allt fungerar under ytan. För den som jobbar med webbutveckling är API:et ett av de viktigaste verktygen att förstå.
Hur ett API fungerar
Ett API fungerar som ett avtal mellan två delar av ett system. Den ena sidan, ofta ett bibliotek eller en tjänst, exponerar en uppsättning funktioner som den andra sidan kan anropa. Programmet som använder API:et känner bara till vad funktionerna gör, inte hur de är implementerade. På så sätt kan utvecklare återanvända redan färdigutvecklad och kvalitetssäkrad kod utan att behöva skriva om den själv.
I praktiken skickar ett program en förfrågan till API:et, och API:et svarar med data eller utfärdar en åtgärd. Förfrågan och svaret följer ett fast format, så att båda parter vet exakt vad som ska skickas och vad som kan förväntas tillbaka. Det är det som gör att system som är byggda i olika programmeringsspråk kan samarbeta.
Olika typer av API:er
Man brukar dela in API:er i två huvudgrupper. Den första typen ger tillgång till systemresurser, oavsett vilket operativsystem programmet körs på. Exempel är drivrutiner för skrivare, filhantering, grafik och radiokretsar som WLAN och Bluetooth. Denna typ kallas ofta för drivrutins-API:er och fungerar som ett lager mellan högnivåprogrammering och lågnivåresurser.
Den andra typen ger tillgång till högnivåfunktioner som återanvänds på olika sätt. Här handlar det ofta om mjukvara som tillhandahålls av andra leverantörer för datahantering eller beräkningar. Exempel är bibliotek för matrisberäkningar och API:er för att skicka e-post. Denna typ kallas ibland för kommersiella API:er eller högnivå-API:er.
Man skiljer också på generella och specifika API:er. Ett generellt API beskriver ett generellt sätt att använda en viss resurs, till exempel ett grafik-API som OpenGL, och gör det möjligt att flytta programvara mellan olika hårdvaruarkitekturer. Ett specifikt API ger tillgång till en specifik resurs, ofta en hårdvaruresurs som ett specialiserat GPS-chip, och är vanligt på mer specialiserade arkitekturer.
API:ets kontrakt
Termen kontrakt används ibland för att beskriva hur ett API eller en API-funktion ska anropas, och vilka villkor som måste vara uppfyllda. Ett kontrakt anger vilka funktioner som finns, vilka parametrar de tar, vilken datatyp returvärdet har och om det finns sidoeffekter. Kontraktet gör det möjligt att kontrollera villkoren innan anropet görs, vilket minskar risken för fel i koden.
I objektorienterad programmering har konceptet design by contract en lång historia, och det finns stöd för det i flera moderna språk. Kontraktet är alltså en del av vad som gör ett API förutsägbart och säkert att använda.
Vanliga API:er och exempel
API:er som många kommer i kontakt med är till exempel DirectX för 3D-grafik, GTK+ för användargränssnitt, OpenGL för 3D-grafik, Win32 för applikationsprogrammering på Windows och ODBC för databaser. Dessa är alla exempel på väldefinierade gränssnitt som låter utvecklare komma åt komplex funktionalitet utan att behöva förstå varje detalj i implementationen.
Inom webbutveckling är REST-API:er och GraphQL två vanliga sätt att bygga API:er som webbapplikationer använder för att hämta och skicka data mellan klient och server. De följer samma grundidé: ett väldefinierade gränssnitt som styr vad som kan begäras och hur svaret ser ut.
API och upphovsrätt
Frågan om vem som äger ett API har prövats i domstol. 2010 stämdes Google av Oracle för att ha implementerat Javakod i Androids operativsystem och sedan distribuerat det utan att ha fått tillåtelse att återanvända Java API. Oracle vann tvisten genom ett avgörande i maj 2014. Målet visar att ett API kan vara ett skyddat verk, och att det är viktigt att känna till vilka villkor som gäller när man bygger på ett andras gränssnitt.
Varför API:er är viktiga för webbutveckling
För den som bygger webbplatser och webbapplikationer är API:er oumbärliga. De gör det möjligt att koppla ihop externa tjänster, till exempel betallösningar, karttjänster eller innehållshanteringssystem, med den egna webbplatsen. I stället för att bygga allt från grunden kan utvecklaren använda befintliga API:er och fokusera på det som gör just den egna produkten unika.
API:er är också det som gör att en webbplats kan kommunicera med en mobilapp, ett externt system eller en annan webbplats. Utan API:er skulle varje integration kräva att man skrev om stora delar av koden för varje nytt system.
Komma igång med API:er
Den som vill börja använda API:er behöver först förstå hur förfrågningar och svar är uppbyggda. De flesta webbaserade API:er använder HTTP som protokoll och returnerar data i format som JSON eller XML. Nästa steg är att läsa API:ets dokumentation, där det står vilka slutpunkter som finns, vilka parametrar som krävs och vad svaret innehåller.
Det är också viktigt att kontrollera vilka villkor som gäller för användningen. Vissa API:er är fria att använda, andra kräver en nyckel eller ett avtal, och vissa har begränsningar på hur många förfrågningar som får göras per timme eller dygn.
Vanliga frågor om API:er
Vad betyder API?
API är en förkortning av application programming interface, på svenska applikationsprogrammeringsgränssnitt.
Behöver man kunna programmera för att använda ett API?
Ja, för att kunna anropa ett API och hantera svaret behöver man kunskaper i minst ett programmeringsspråk. Men man behöver inte förstå hur API:et är internt implementerat.
Är alla API:er gratis?
Nej. Vissa API:er är öppna och fria att använda, andra är kommersiella och kräver betalning, ett avtal eller en API-nyckel.
Kan ett API bytas ut utan att det påverkar programmet?
Ja, om det nya API:et följer samma kontrakt som det gamla kan programmet som använder det fortsätta att fungera utan ändringar. Det är en av de stora fördelarna med att arbeta via ett väldefinierade gränssnitt.
Relaterade artiklar

React: vad det är och hur det fungerar
React är ett JavaScript-bibliotek för att bygga användargränssnitt med komponenter. Här går vi igenom vad det är, vem som står bakom och hur det skiljer sig från andra verktyg.
Läs artikeln
Webbhotell: så väljer du rätt leverantör
Ett webbhotell lagrar din hemsidas filer på en server så att de kan besökas online. Här är vad du ska titta på när du väljer webbhotell: driftstid, hastighet, support, säkerhet med mera.
Läs artikeln
Webbutveckling – en guide till att bygga webbplatser och webbapplikationer
Vad är webbutveckling och hur bygger man en webbplats? En guide till frontend, backend, HTML, CSS, JavaScript, säkerhet och prestanda.
Läs artikeln
TypeScript: programmeringsspråket med statisk typkontroll
TypeScript är ett öppet programmeringsspråk från Microsoft som bygger på JavaScript och lägger till statisk typkontroll. Här är vad det är, hur kompileringen fungerar och varför det passar större projekt.
Läs artikeln