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:
- Appen sender en forespørsel: «Gi meg værdata for Bergen».
- Værtjenesten behandler forespørselen og sender et svar med værdata.
- 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:
- Oversettelse: Et arbeidsverktøy sender tekst til en oversettelsestjeneste og mottar et forslag. Skal du velge arbeidsmåte, se guiden om å oversette engelsk til norsk.
- Dokumentflyt: Et system sender dokumentinnhold videre til behandling. Før du automatiserer dette, bør du vurdere format og hvilke opplysninger som deles. Les også om å oversette dokumenter med hensyn til kvalitet og personvern.
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.
- Definer oppgaven. Skriv ned hvilke data eller handlinger du faktisk trenger.
- Finn dokumentasjonen hos leverandøren. Kontroller hva API-et støtter, og hvilke vilkår som gjelder.
- Avklar tilgang. Undersøk om løsningen krever konto, særskilte tillatelser eller en API-nøkkel. Ikke anta at tilgang er gratis.
- Begynn forsiktig. Velg en dokumentert prøve som ikke endrer viktige data, og bruk ufølsomt testinnhold.
- 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.
Var noe uklart eller feil?
Send en rettelse til hello@nyhetslinjen.net