Vad är ett API och hur kan du använda dem?

Har du någonsin använt en mobilapp eller en webbtjänst och undrat hur den fungerar bakom kulisserna? Hur hämtar en app data från en databas eller annan tjänst på internet och visar upp informationen? Svaret är API:er - Application Programming Interface.

När jag bygger webbapplikationer idag använder jag API:er nästan dagligen. De är helt enkelt ett viktigt verktyg för att hämta och skriva data från olika databaser och tjänster.

I den här artikeln kommer vi att utforska vad API:er är och hur du kan använda dem i dina egna projekt som nybörjare.

Vad är ett API?

API står för Application Programming Interface och fungerar som en brygga som tillåter olika applikationer att kommunicera med varandra.

Tänk på det som en meny på en restaurang - menyn berättar vad du kan beställa, och köket levererar det du begär. På samma sätt beskriver ett API vilka funktioner och data du kan begära från en tjänst, och tjänsten svarar med det du bad om.

Hur fungerar ett API i praktiken?

Låt oss ta ett konkret exempel. När du använder en väderapp på din mobil händer följande bakom kulisserna:

Appen skickar en HTTP-förfrågan till ett väder-API med information om vilken stad du vill veta vädret för
API:et tar emot förfrågan, kontrollerar att du har rätt att använda tjänsten (via en API-nyckel)
API:et hämtar väderdata från sin databas
API:et skickar tillbaka data i ett strukturerat format som heter JSON
Din app tar emot datan och visar upp den snyggt på skärmen

Här är ett förenklat exempel på hur ett faktiskt API-anrop ser ut:

// Skicka en GET-förfrågan till väder-API:et
const response = await fetch('https://api.weather.com/v1/current?city=Stockholm', {
  headers: {
    'Authorization': 'Bearer din-api-nyckel-här'
  }
});

// Svaret kommer tillbaka i JSON-format
const data = await response.json();
console.log(data);
// Output: {"temperature": 5, "condition": "molnigt", "humidity": 78}

REST och HTTP-metoder

De flesta moderna API:er följer en standard som kallas REST (Representational State Transfer). Ett RESTful API använder HTTP-protokollets standardmetoder för att utföra olika operationer:

GET - Hämta data (som att läsa information från en databas)

GET https://api.example.com/users/123
// Hämtar information om användare med ID 123

POST - Skapa ny data (som att lägga till en ny användare)

POST https://api.example.com/users
Body: {"name": "Anna", "email": "anna@example.com"}

PUT - Uppdatera befintlig data helt och hållet

PUT https://api.example.com/users/123
Body: {"name": "Anna Andersson", "email": "anna.new@example.com"}

DELETE - Ta bort data permanent

DELETE https://api.example.com/users/123

Endpoints och JSON-format

Varje funktion i ett API nås via en specifik URL som kallas en endpoint. Endpoints är strukturerade på ett logiskt sätt:

api.example.com/users - Lista alla användare
api.example.com/users/123 - Hämta en specifik användare
api.example.com/users/123/posts - Hämta alla inlägg av den användaren

När API:et svarar kommer datan i JSON-format (JavaScript Object Notation), som både människor och kod kan läsa enkelt:

{
  "city": "Stockholm",
  "temperature": 5,
  "condition": "molnigt",
  "forecast": [
    {"day": "Måndag", "temp": 7},
    {"day": "Tisdag", "temp": 6}
  ]
}

Säkerhet och API-nycklar

De flesta API:er kräver att du identifierar dig med en API-nyckel - en unik kod som fungerar som ditt passerkort till tjänsten. Detta gör att API-leverantören kan:

Verifiera att du har rätt att använda API:et
Hålla koll på hur mycket du använder tjänsten
Begränsa antalet anrop om du överskrider din kvot
Blockera missbruk av tjänsten

Här är hur du använder en API-nyckel i praktiken:

import requests

headers = {
    "Authorization": "Bearer din-hemliga-api-nyckel",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://api.weather.com/v1/current?city=Stockholm",
    headers=headers
)

data = response.json()
print(f"Temperatur: {data['temperature']}°C")

Viktigt att komma ihåg: Behandla din API-nyckel som ett lösenord. Lägg aldrig nyckeln direkt i din kod som ska delas publikt. Använd istället miljövariabler eller konfigurationsfiler som inte checkas in i versionshantering.

Varför är API:er så viktiga?

API:er har blivit fundamentet för modern webbutveckling av flera anledningar:

Separation av frontend och backend - Din app kan vara byggd i React medan API:et är skrivet i Python. De kommunicerar via HTTP oavsett vilket språk som används.
Återanvändbarhet - Ett och samma API kan användas av webbapplikationer, mobilappar, desktop-program och till och med andra tjänster.
Integration av externa tjänster - Istället för att bygga egen betalningslösning kan du använda Stripes API. Istället för att bygga ett kartsystem använder du Google Maps API. Detta sparar tusentals utvecklingstimmar.
Automatisering - Med API:er kan du skriva script som automatiskt hämtar data, skapar rapporter och synkroniserar information mellan olika system.

När jag bygger webbapplikationer idag är API:er helt centrala. Nästan varje projekt jag arbetar med kommunicerar med flera olika API:er - både externa tjänster och våra egna interna API:er.

Var hittar man användbara API:er?

Oavsett vilket projekt du arbetar på eller funderar på att bygga brukar det finnas flera användbara API:er att tillgå. En del är gratis, medan andra kostar lite per förfrågan.

Några av de mest populära API:erna är:

OpenWeather API: Hämta väderinformation för en specifik stad.
Giphy API: Hämta gif-bilder baserat på sökord eller kategorier.
Twitter API: Hämta och skapa tweets på Twitter.
Google Maps API: Hämta kartor och platser från Google Maps.

Ett bra ställe att hitta API:er är också genom RapidAPI. Det är en marknadsplats där man i princip kan hitta olika API:er för vad som helst.

Det går dessutom att skapa sina egna API:er och lägga upp det på deras plattform. Dina egna API:er kan du sedan använda för dina egna projekt eller så kan du sälja dem till andra utvecklare.

Automatisering och användningsområden

Ett av de mest kraftfulla sätten att använda API:er är för automatisering. Istället för att manuellt utföra upprepade uppgifter kan du skriva scripts som gör jobbet åt dig.

Datasynkronisering mellan system

I mitt arbete med olika projekt har jag använt API:er för att synkronisera data mellan olika system. Ett exempel är när jag byggde en dashboard som samlade information från flera olika källor - e-handel, CRM-system och analyser - på en och samma plats.

Genom att anropa olika API:er med jämna intervaller kunde systemet alltid visa uppdaterad information utan att jag behövde logga in på varje tjänst separat.

Integration av externa tjänster

API:er gör det möjligt att integrera kraftfulla externa tjänster i dina egna applikationer. Några konkreta exempel:

Betalningar - Genom Stripe eller PayPal API kan du hantera betalningar utan att bygga ett eget betalningssystem.
Kartfunktionalitet - Google Maps API ger dig tillgång till kartor, vägbeskrivningar och platsdata.
AI och maskininlärning - OpenAI API låter dig integrera avancerad AI-funktionalitet i dina appar.

Det fantastiska med API:er är att de låter oss utvecklare bygga på andras arbete. Istället för att behöva bygga allt från grunden kan vi integrera färdiga tjänster och fokusera på det som är unikt för vårt projekt.

Skapa dina egna automatiseringar

När du är bekväm med grunderna kan du börja experimentera med egna automatiseringar. Tänk på upprepade uppgifter i din vardag som skulle kunna automatiseras:

Ladda ner och spara artiklar från dina favoritsajter
Övervaka prisändringar på produkter du är intresserad av
Samla statistik från dina sociala medier-konton
Automatiskt säkerhetskopiera data från olika tjänster

Med API:er och lite kod kan du spara många timmar manuellt arbete och skapa system som arbetar åt dig dygnet runt.