Verktøy og feilsøking

Hva er et API? En enkel forklaring med eksempler

Et API er et grensesnitt som lar programmer kommunisere med hverandre. Det gjør at en app kan be om data eller funksjoner fra et annet system uten at brukeren må gjøre jobben manuelt.

API forklart uten fagspråk

API står for Application Programming Interface, på norsk gjerne kalt programmeringsgrensesnitt. Tenk på det som en avtalt måte å samarbeide på: Ett program vet hvilke spørsmål det kan stille, og det andre vet hvordan det skal svare. Denne grunnbetydningen er beskrevet i MDNs forklaring av API.

Et API er ikke nødvendigvis en nettside eller en database. Begrepet handler om grensesnittet mellom programmer, ikke om hvor informasjonen lagres. Du kan bruke en app som benytter API-er uten selv å programmere.

Eksempel: En oppdiktet værapp

Forenklet, fiktivt eksempel: Du åpner en værapp og velger Bergen. Samspillet kan se slik ut:

  1. Appen sender en forespørsel: «Gi meg værdata for Bergen».
  2. Værtjenesten behandler forespørselen og sender et svar med værdata.
  3. Appen presenterer svaret som tekst, symboler eller en graf.

Forespørselen er det appen ber om. Svaret er det den mottar. Eksemplet viser prinsippet, ikke en faktisk tjeneste, adresse eller værmelding.

Andre situasjoner der API-er kan være nyttige

Her er to tenkte bruksområder, ikke bekreftede funksjoner i bestemte produkter:

Hva trenger du for å bruke et API selv?

For å forstå begrepet trenger du ingen konto eller tekniske verktøy. Skal du koble sammen systemer, er leverandørens offisielle dokumentasjon utgangspunktet. Det finnes ingen universell oppskrift som passer alle API-er.

  1. Definer oppgaven. Skriv ned hvilke data eller handlinger du faktisk trenger.
  2. Finn dokumentasjonen hos leverandøren. Kontroller hva API-et støtter, og hvilke vilkår som gjelder.
  3. Avklar tilgang. Undersøk om løsningen krever konto, særskilte tillatelser eller en API-nøkkel. Ikke anta at tilgang er gratis.
  4. Begynn forsiktig. Velg en dokumentert prøve som ikke endrer viktige data, og bruk ufølsomt testinnhold.
  5. Kontroller resultatet. Vurder om svaret faktisk løser oppgaven før du bygger videre.

Dette er generelle arbeidsråd. Krav til innlogging, formater, kostnader og bruksgrenser må sjekkes hos den aktuelle leverandøren.

Sikkerhet og når du bør stoppe

Kontroller nettstedets adresse før du logger inn eller oppretter tilgang. Nettvett understreker at HTTPS ikke alene viser at et nettsted er legitimt. Behandle eventuelle API-nøkler som hemmeligheter, og ikke legg dem i offentlige eksempler eller skjermbilder.

Hvis en nettbasert integrasjon feiler, sjekk først om andre nettjenester virker. Ved generelle tilkoblingsproblemer kan guiden om tregt Wi-Fi hjelpe deg å avgrense problemet. For Windows har Microsoft en offisiell veiledning for Wi-Fi-feilsøking.

Stopp dersom du er usikker på tillatelser, deling av personopplysninger eller om en forespørsel kan endre eller slette data. Kontakt leverandørens offisielle støtte eller systemansvarlig. Beskriv oppgaven og feilmeldingen, men fjern hemmeligheter og personopplysninger før du deler dem.