Vet du egentlig hva et API er? Eller har du noen gang prøvd å forklare det til noen på en enkel måte? Det kan være vanskelig, så her er en enkel og praktisk forklaring på hva et API er og hvordan det fungerer.
Du kan se for deg at du går til en restaurant, ser på menyen og bestiller en rett. En kelner tar bestillingen og gir den til kokken, som lager bestillingen og sender den ut til deg ved hjelp av kelneren. I dette eksempelet er du en bruker, kelneren et API og kokken en datakilde. Menyen hjelper deg med formatet på bestillingen og kan sees på som dokumentasjonen til APIet. I stedet for mat er det data APIet tar med seg tilbake til brukeren, og det kan være alt fra badetemperaturer i Oslo til når neste fly ankommer Flesland.
API står for Application Programming Interface og er kort forklart en port eller et standardisert grensesnitt mellom to maskiner som skal spørre om, sende og motta data. For å utføre denne prosessen må man spørre etter dataen på en måte som er definert av dem som har laget APIet. Tadata tilbyr deg en plattform hvor du enkelt kan søke etter, finne og teste APIer uten å måtte sette deg inn i komplisert dokumentasjon. Enkelt, raskt og brukervennlig.
Dataformat
Dataformatet du får ut av et API varierer. Det er ingen standard, men de vanligste formatene er JSON, xml og csv. Mange APIer tilbyr data på flere formater og da må du selv definere hvilket format du vil ha i spørringen. Noen ganger vil du hente ut et datasett én gang, mens andre ganger ønsker du å “abonnere” på en datastrøm eller implementere et søk i en applikasjon du selv lager. Det vanligste formatet å bruke for implementering er JSON, men ved uthenting av datasett er csv et mye brukt alternativ.
Input — Output
Ofte er databasene eller datasettene APIene gir deg tilgang til veldig store og det lønner seg å snevre inn søket til det du faktisk har bruk for. Akkurat hvilken data du vil hente ut kan du styre ved hjelp av input parametere. Dette kan for eksempel være et gitt tidsrom, et geografisk område eller andre begrensninger. På Tadata kan du se en liste over de mulige input parametere du kan sette for APIet, og hvilken output eller resultat du får ut av spørringen.
Header, API nøkkel og metode
Noen APIer krever at du identifiserer deg som bruker. Da krever APIet at du legger inn en nøkkel, ofte en lang rekke tall og bokstaver, i headeren eller “infofeltet” til spørringen. Denne nøkkelen får eller kjøper du av datatilbyderen som dermed godkjenner at du skal få tilgang til dataen du spør om. I headeren til spørringen ligger også metadata om hvordan applikasjonen eller nettleseren du sender spørringen fra kan motta dataen. Hvis du sender spørringen via adressefeltet i nettleseren, legges dette ved direkte, men hvis du skal motta dataen i en annen applikasjon må denne informasjonen defineres.
Type APIer
Det finnes mange typer APIer. Man snakker ofte om Public (offentlige) eller Private (private) APIer, Åpne og Begrensede APIer eller forskjellige standarder. Offentlige APIer kan for eksempel være enten åpne eller begrensede, mens private APIer stort sett er begrensede og kun for internt bruk hos eieren av dataen. Når det kommer til standarder er de mest brukte REST (eller RESTful), GraphQL, RPC og SOAP. Forskjellene mellom disse er måten spørringene er strukturert på, eller reglene som spørringene må følge. I dag brukes for det meste REST og GraphQL for integrasjoner, mens SOAP og RPC henger igjen i de litt eldre systemene.
Metode
Det finnes også flere metoder å prate med et API på, men de vanligste er såkalte POST og GET forespørsler. Kort fortalt brukes POST når du skal skrive noe inn til datakilden, mens GET brukes når du skal hente noe ut. Dette er litt forenklet, da API-typer som GraphQL og SOAP i stor grad bruker POST også for å spørre om data ut.
Ett steg av gangen
Det kan være i overkant mye å forholde seg til alle disse begrepene når man skal begynne å forstå og jobbe med APIer, men du må ikke bli skremt. Du kan komme veldig langt bare ved en enkel forståelse av prinsippene om å spørre om noe og få noe i retur. Vi anbefaler deg å lære ved å gjøre. Ta turen til tadata.no for å leke deg rundt med eksempler og teste hva du kan få til med APIene hos oss.
På Tadata finner du en oversikt over tilgjengelige APIer og datakilder i Norge. Vi ønsker at data enkelt skal kunne deles og settes sammen på nye måter, få nytt liv og legge grunnlaget for ekspansiv verdiskaping. Data er den nye oljen og Tadata tar borejobben.
