Vad är ett API?
Ett API (Application Program Interface) fungerar som en bro mellan exempelvis två system och är ett kontrollerat sätt att överföra information på. Det finns flera API-typer varav REST API och SOAP API är bland de vanligare. Skatteverket erbjuder båda.
Det betyder API
Förkortningen API står för Application Program Interface. Det är ett numera standardiserat sätt att överföra information som vi använder dagligen, kanske ofta utan att veta om det. Det är exempelvis API:er som förser våra mobilappar med allt från väderprognoser till träningsscheman, och bokföringssystem med saldon från en bank.
Så fungerar ett API
Ett API består av byggstenar, så kallade endpoints, som tillsammans gör det möjligt att skapa precisa, effektiva och komplexa lösningar som möter ett specifikt behov. Ett API kan enkelt beskrivas som en bro mellan två eller flera program, system eller applikationer. Tack vare API:et kan dessa prata med varandra. Ofta beskrivs det därför som en mellanhand, en översättare som hjälper två parter som inte pratar samma språk att ändå kommunicera.
Därför ska du använda dem
API:er är idag en given ingrediens i verksamheters interna processer och externa erbjudanden. Med hjälp av dem kan du exempelvis:
- överföra information automatiskt och därmed slippa manuell handpåläggning och den ökande risken för fel som det ofta innebär,
- låta utvecklare återanvända delar av tekniska lösningar vilken gör att produkter och funktionalitet kan nå marknaden snabbare,
- förbättra den digitala användarupplevelsen genom att sömlöst kunna paketera information från olika ställen på ett smidigt och effektivt sätt,
- öppna upp för innovation hos andra aktörer som med hjälp av ditt API kan utveckla nya lösningar.
Tre exempel på hur API:er används idag
- Storstockholms Lokaltrafik (SL) delar med sig av sina tidtabeller via API. Det här gör att fler aktörer på marknaden kan bygga lösningar med korrekta uppgifter direkt från källan.
- Google Maps är ett Google-byggt API som hjälper miljoner människor att dagligen hitta dit de ska. API:et är även öppet för andra att använda vilken ofta utnyttjas i parkeringsappar.
- Skatteverkets eget API Skattekonto hjälper företagare att se sitt saldo från just skattekontot direkt i sina valda bokförings- eller redovisningsprogram. API:et berättar med hjälp av fördefinierade regler vilken information som får skickas mellan systemen.
Skillnad på REST API och SOAP API
Det finns flera typer av API:er men de två kanske mest använda är REST API och SOAP API.
REST
REST står för Representation State Transfer och är ett flexibelt API som kan hantera flera typer av anrop och format. De vanligaste formaten är JSON och XML. Utvecklare anser ofta att REST API:er är enklare att implementera, förstå och felsöka vilket gör det möjligt att bygga lösningar som möter många olika behov. REST är också skalbart på ett helt annat sätt än SOAP.
Skatteverkets API om arbetsgivardeklaration är ett exempel på REST API:
SOAP
SOAP står för Simple Object Access Protocol och är mer komplext än REST. SOAP har inte möjlighet att cache:a data och behöver all information om en interaktion innan några överföringar ens påbörjats. Det här kräver strikta regler och avancerade säkerhetslösningar och dessutom mer bandbredd. API:et använder XML för att överföra data.
Skatteverkets API Faderskapsutredning är ett exempel på SOAP API:
Öppna och stängda API:er
Vissa API:er är fria för alla att använda utan några motkrav, vissa kan bara användas efter att du skrivit på ett avtal eller kanske betalat en summa pengar. Många beskriver den här skillnaden som att det finns öppna och stängda API:er.
Det som dock kan förvirra är att begreppet ”Öppna API:er” ofta används i båda dessa fall, det beror lite på vem du frågar. Du kan nämligen behöva skriva på något för att få använda ett öppet API, men när det väl är gjort kan du nyttja informationen precis hur du vill.
För att hålla isär vad som är vad så kan du exempelvis fråga dig själv följande: får jag göra vad jag vill med informationen som jag får via API:et eller finns det regler som bestämmer användningen?
Skatteverkets API:er
Skatteverket delar upp sina API:er i tre kategorier: partner-API, öppna data-API och riktat API.
Läs mer om dem:
Upptäck hela utbudet på Utvecklarportalen: