4.1 Hva er et API?

Når du bruker en værapp på mobilen, spiller musikk på Spotify, eller deler en Instagram-post, kommuniserer appen med servere på internett for å hente og sende data. Dette skjer gjennom noe som kalles et API (Application Programming Interface).

Et API er i praksis et grensesnitt som lar to programmer snakke sammen. I stedet for at mennesker klikker på knapper i et brukergrensesnitt, sender programmer forespørsler til hverandre og utveksler data automatisk.

I dette kapittelet skal vi se på hva et API er, hvordan REST API-er fungerer, og hvordan data typisk utveksles i JSON-format.

La oss bruke en restaurant-analogi:

Restaurant = Server med API
- Menyen = API-dokumentasjonen (liste over hva du kan bestille)
- Servitøren = API-et (tar imot bestillingen og leverer maten)
- Kjøkkenet = Server/database (lager maten/dataene)
- Du = Klientprogrammet (bestiller mat/data)

Du velger noe fra menyen, forteller servitøren hva du vil ha, servitøren går til kjøkkenet, og kommer tilbake med maten. Du trenger ikke vite hvordan kjøkkenet lager maten, bare hva du kan bestille og hvordan du bestiller det.

På samme måte sender et program en forespørsel til et API, API-et henter data fra databasen, og sender tilbake et svar med dataene.

Et API består av flere endepunkter (endpoints), som er spesifikke URL-er som utfører ulike funksjoner.

Eksempel fra et sosiale medier-API:
- GET /users/123 – Hent bruker med ID 123
- GET /users/123/posts – Hent alle poster fra bruker 123
- POST /posts – Opprett ny post
- PUT /posts/456 – Oppdater post med ID 456
- DELETE /posts/456 – Slett post med ID 456

Hvert endepunkt har:
- En URL (adressen)
- En HTTP-metode (GET, POST, osv.)
- Parametre (valgfri data som sendes med)
- Et svar (data som returneres)

Alle gode API-er har dokumentasjon som forklarer:
- Hvilke endepunkter som finnes
- Hvilke HTTP-metoder som støttes
- Hvilke parametre som kreves
- Hvilket format svaret har
- Eksempler på bruk
- Autentisering (hvis nødvendig)

Eksempel på dokumentasjon:

Endepunkt: GET /books/{id}
Beskrivelse: Hent informasjon om en bok

Parametre:
  - id (required): Bokens ID-nummer

Svar (200 OK):
{
  "id": 123,
  "title": "1984",
  "author": "George Orwell",
  "year": 1949
}

Feilkoder:
  - 404: Bok ikke funnet
  - 500: Serverfeil

Før du bruker et API, bør du alltid lese dokumentasjonen nøye.

Mange API-er krever autentisering for å sikre at bare autoriserte brukere får tilgang. Den vanligste metoden er å bruke en API-nøkkel.

Hvorfor API-nøkler?
- Hindre misbruk (for mange forespørsler)
- Spore hvem som bruker API-et
- Begrense tilgang til betalte funksjoner
- Sikkerhet (hindre uautorisert tilgang)

Bruk av API-nøkkel:
API-nøkkelen sendes vanligvis som en parameter eller i HTTP-headeren:

GET https://api.example.com/data?api_key=DIN_HEMMELIGE_NØKKEL

eller

GET https://api.example.com/data
Headers: {
  "Authorization": "Bearer DIN_HEMMELIGE_NØKKEL"
}

Viktig: Behandle API-nøkler som passord – del dem aldri offentlig!

Oppsummering

I dette kapittelet har du lært:

- API: regler og protokoller som lar programmer kommunisere.
- HTTP-metoder: GET, POST, PUT og DELETE.
- REST: arkitekturstil for web-API-er.
- JSON: tekstbasert dataformat for datautveksling.
- Praktisk bruk: hente data fra ulike API-er.

Noekkelbegreper