Hva står API for? Eksempler på hvordan du bruker APIer

API står for "Application Programming Interface". Og selv om dette kan høres rart ut hvis du ikke har begynt å programmere, er de enkle å forstå når du bryter den ned. Du bruker dem til og med daglig mens du bruker mobiltelefonen, PCen eller mens du surfer på internett.

Programvare, inkludert webapper, mobilapper og mange andre programmer, knytter verden sammen via internett. Men for å gjøre dette mer effektivt, må det være en kommunikasjonskanal mellom denne programvaren - det er her en API kommer inn.

Her forklarer vi betydningen av APIer og hvordan du bruker dem.

Hva er en API?

Vet du hvordan du kan se videoer på streamingplattformer som blant annet Netflix og YouTube? Det er mulig fordi du sender en forespørsel via et API.

Eller har du sett for deg hvordan du kan betale for varene du kjøper fra nettbutikker som Amazon og eBay? Det er også fordi det er en kommunikasjonskanal kjent som et API mellom banken din og shoppingappene.

Når det er sagt, er et API et grensesnitt med et sett med regler som gjør at appens server kan samhandle med en løsningsserveres server slik at du kan bruke ressursene deres. I hovedsak definerer den hvordan apper eller programvare kommuniserer med hverandre.

I noen tilfeller tillater imidlertid et API gjensidig utveksling av data. Et eksempel er en forbindelse som eksisterer mellom bankappene dine og nettbutikkappene.

En API er som en messenger. Den kobles til en leverandørs server i den ene enden og forankrer også klientens server i den andre enden. Deretter anbuder klientens forespørsel til datakilden (leverandørens server) og returnerer et svar til klienten. En klient her er nettleseren eller appen din.

En krok fester imidlertid appen din til API. Det er et API-endepunkt. Imidlertid utfolder mange ting seg bak scenen. Vi forklarer disse nærmere.

Hvordan API-er hjelper deg med å utvikle apper raskere

APIer er et smartere verktøy for å bygge sømløse og robuste applikasjoner. Uten dem ville det bygge aldre å bygge sofistikerte apper.

Tenk deg at du trenger appen din for å utføre komplekse operasjoner, den typen det tar massevis av tid og krefter å bygge. Og så dukker noen opp med et ferdig program som gjør akkurat det du vil, og muligens bedre.

Men hvordan kan du koble dette til appen din? Leverandøren, som innser at dette kan gi deg litt vanskelig tid, fortalte deg at de opprettet et tilkoblingsgrensesnitt (API) som gjør at koden og din integreres sømløst.

Det grensesnittet (API) kobles til serveren som inneholder koden. Så gir den deg relevante data fra handlingen av skriptet.

Selvfølgelig vil du ikke kjede deg med hele kildeskriptet. Dessuten er de fleste av de moderne APIene nå avhengige av standardisert REST (Representational State Transfer) -teknologi. Det gjør dem svært skalerbare og enkle å integrere, uten at du trenger å bekymre deg for hva som utspiller seg i eller tilstanden til svaret eller forespørselen din når de er forhåndsformaterte.

Denne artikkelen forklarer ikke REST API. Fokuser på det grunnleggende for nå.

Å koble koden din til deres er en bedre ide enn å skrive den fra bunnen av. For å gjøre det, må du imidlertid koble koden din med API-en de har gitt. Hvordan gjør du dette? Det er der et API-endepunkt kommer inn på scenen.

Hva er et API-endepunkt?

For å forenkle ting, setter leverandørene opp en URL for å gjøre det enkelt å koble til API-en. En slik URL er en API-endepunkt. Med det kan appen din få tilgang til serveren deres via API og kommunisere med skriptet direkte.

Så alt du trenger å gjøre er å ta tak i endepunktet, lime det inn i koden din, komme med forespørsler med det, tilpasse svarene, og så fungerer det, og det er ditt! Et API-sluttpunkt binder derfor appen din via en API til en løsning eller datakilde.

Til slutt er mange av programmene som tilbyr API-er tilgjengelige på forskjellige programmeringsspråk, slik at ingen blir ekskludert fra å dra nytte av dem.

På den måten kommer du til å kode raskere og mer effektivt, vel vitende om at plikten til å opprettholde API ikke er på deg, men data- eller løsningsleverandørene.

Derfor er et API-endepunkt en kommunikasjonskrok som binder en API til en ressursserver i den ene kanten og kobler den til mottakerens server i den andre enden.

Det betyr da at du ikke trenger hele skriptet til løsningen du vil bruke. Men koden din kan ikke opprette kommunikasjon med den hvis den ikke kobler til API-endepunktet.

API-integrasjonsregler

Det er ingen vanskelig regel for integrering av et API. Det er massevis av dem der ute, og hver av dem har sine integreringsregler. Men husk at du forventer en respons når du oppretter en forbindelse med et API.

Hvordan du gjør forespørsler gjennom et API-endepunkt er vanligvis basert på leverandørdefinerte regler, men hva du gjør med svaret du får, avhenger av dine preferanser. I hovedsak kan du vri det når du vil for å overholde appens brukeres opplevelse og grensesnitt.

Noen ganger trenger du også en autentisator før du får tilgang til et API. Slike autentisatorer kommer vanligvis som tilgangstokener eller API-nøkler. Når dette tokenet har bestått en godkjenningstest, signaliserer APIen sluttpunktet for å opprette en forbindelse mellom appen din og leverandørens server.

Som API-forbruker trenger du ikke bekymre deg for disse parametrene fordi API-leverandøren gjør dem tilgjengelige. En flott API bør også oppgi hvordan du får tilgang til og bruker ressursene i dokumentasjonen. Så se alltid etter det når du prøver å integrere en.

For å avrunde det handler en API-samtale om topptekster, en endepunkt, den be om, og respons eller kropp.

Mens vi har forklart hva et endepunkt er, la oss bryte ned disse andre vilkårene ytterligere:

Overskrifter

Vanligvis må du beskrive to former for overskrifter mens du kobler til et API: be om og respons topptekster.

De forespørselstittel er porten til en API-samtale. Den beskriver en klients tilnærming til tilgang til en ressurs. Det kan detaljere ting som akseptabel tilkoblingstype, proxy-informasjon og datatypen (JSON, XML eller HTML) du vil få fra API.

Som vi har beskrevet tidligere, avhengig av typen API du kobler til, kan det hende du må oppgi et unikt autentiseringstoken også i forespørselstittelen. Tilbyderen gir vanligvis dette.

De svarhodederimot, er en påstand om dataene som kommer fra leverandørens server. Det gir appen din informasjon om leverandørens egenskaper. I hovedsak sikrer det at appen din gir tilgang til svaret som kommer fra API.

API-forespørsel

En API-forespørsel inneholder vanligvis sluttpunktet i en URL (Unique Resource Locator). Den bruker Hypertext Transfer Protocol (HTTP) for å finne adressen til ressursen du prøver å få tilgang til med et API. Til slutt er en API-forespørsel ikke fullført hvis du ikke inkluderer endepunktet i URL-en.

API-svar

Et svar er hva en API sender tilbake hver gang den mottar en forespørsel fra appen din. Det kan være JSON, XML eller HTML, avhengig av data eller innholdstype den mottar fra forespørselstittelen.

Når du har fått svar fra en API, kan du vurdere at API-anropet ditt er vellykket.

Slik bruker du APIer: Praktiske eksempler

Nå som du vet grunnleggende API-er og hva du trenger for å integrere en. Ta en titt på hvordan du kobler til og integrerer en API for fotballspådommer fra RapidAPI ved hjelp av Python nedenfor.

Det er en enkel API-samtale som returnerer et JSON-svar. Du kan også skrive koden din hvilken som helst tekstredigerer, og kjør den via kommandolinjen.

I slekt: Hvordan kjøre Python-skriptet

Vær imidlertid nøye med sluttpunktet, innholdet i forespørselsoverskriftene og svaroverskriftene:

importforespørsler
endepunkt = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
#Definer forespørselstittelen:
overskrifter = {
'x-rapidapi-key': "Lim inn tilgangsnøkkelen her",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
#Definer svaret:
respons = requests.request ("GET", endepunkt, headers = headers, params = queryparams)
#Få svaret:
skriv ut (respons.tekst)

Fortsett å lære: Hvordan bruke IPStack API for IP Geolocation Lookups

Hva med å få den aktuelle temperaturen og fuktigheten til et sted ved hjelp av API for Weatherstack med Python? Her er et eksempel nedenfor:

importforespørsler
endepunkt = ' http://api.weatherstack.com/current'
overskrifter = {
"access_key": "Lim inn tilgangsnøkkelen din her",
"query": "California"
}
req = requests.get (endepunkt, overskrifter)
res = req.json ()
skriv ut (u "Nåværende temperatur i% s er% d ℃"% 
(res ["location"] ["name"], res ["current"] ["temperature"]))
skriv ut (u "Nåværende luftfuktighet i% s er% d ℃"% 
(res ["location"] ["name"], res ["current"] ["fuktighet"]))

Typer APIer du kan integrere

APIer med åpen kildekode er gratis, og alle kan bruke dem. Interne API-er ligger i en organisasjon, og bare apper som tilhører den organisasjonen kan bruke ressursene.

Du kan imidlertid også velge en dedikert API ved å inngå en partnerskapsavtale med en leverandør. Eller du kan kombinere flere API-er for å løse ulike problemer.

Disse API-ene, unntatt open source og interne APIer, kan også ha en pris, noen ganger fra hundrevis til tusenvis av dollar.

Forenkle apputvikling med APIer

Som du kan se, at du ikke trenger å skrive tidkrevende kode lenger. Hvis du trenger appen din for å utføre komplekse operasjoner, kan du alltid søke der ute og hente et relevant API. Heldigvis er de nå til og med enkle å integrere enn gamle konvensjonelle. Og hvis du er nysgjerrig og vil vite mer, er det mange gratis API-er der ute som kan hjelpe deg å skitne hendene.

Hvordan API-er fungerer og hvordan du integrerer dem i appen din

Å bruke applikasjonsprogrammeringsgrensesnitt (APIer) er en viktig ferdighet for alle programmerere å mestre.

Les Neste

Om forfatteren