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

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 er ny i programmering, er de enkle å forstå når du bryter det ned. Du bruker dem til og med daglig mens du bruker mobiltelefonen, PC -en eller mens du surfer på internett.





Programvare, inkludert nettapper, 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 der et API kommer inn.





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





Hva er et API?

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

Eller har du forestilt 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øsningsleverandørs 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 mellom bankappene og nettbutikkappene.





Et API er som en budbringer. Den kobles til en leverandørs server i den ene enden og forankrer også klientens server i den andre enden. Den sender deretter 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 -en. Det er et API -endepunkt. Mange ting utspiller seg imidlertid bak scenen. Vi forklarer disse nærmere.





Hvordan APIer hjelper deg med å utvikle apper raskere

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

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

hvordan rotere børsten i Photoshop

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

Det grensesnittet (API) kobles til serveren som inneholder koden. Deretter gir den deg tilbake de relevante dataene fra handlingen i skriptet deres.

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

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

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

Hva er et API -endepunkt?

For å forenkle tingene legger leverandørene deretter opp en nettadresse for å gjøre koblingen til API -en sømløs. Slik URL er en API -endepunkt . Med den kan appen din få tilgang til serveren sin via API og kommunisere direkte med skriptet sitt.

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

Til syvende og sist er mange av programmene som tilbyr APIer tilgjengelige på forskjellige programmeringsspråk, slik at ingen blir ekskludert fra å dra fordel av dem.

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

Derfor er et API -endepunkt en kommunikasjonskrok som binder et 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 seg til API -endepunktet.

API -integreringsregler

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

Hvordan du sender forespørsler via et API-endepunkt er vanligvis basert på leverandørdefinerte regler, men hva du gjør med svaret du får, avhenger av preferansen din. I hovedsak kan du vri det slik du vil for å passe til appens brukeres opplevelse og grensesnitt.

Noen ganger trenger du også en autentisering før du får tilgang til et API. Slike autentifikatorer kommer vanligvis som tilgangstokener eller API -nøkler. Når dette tokenet består en godkjenningstest, signalerer API -et deretter endepunktet for å opprette en forbindelse mellom appen din og leverandørens server.

Som API -forbruker trenger du ikke bekymre deg for disse parameterne fordi API -leverandøren gjør dem tilgjengelige. Et flott API bør også angi hvordan du kan få tilgang til og bruke ressursene i dokumentasjonen. Så pass alltid på det når du prøver å integrere en.

For å avrunde det, handler et API -anrop om overskrifter , en endepunkt , be om , og respons eller kropp .

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

Overskrifter

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

De be om topptekst er inngangsporten til et API -anrop. Den beskriver en klients tilnærming til tilgang til en ressurs. Det kan inneholde detaljer om akseptabel tilkoblingstype, proxy -informasjon og datatypen (JSON, XML eller HTML) du vil hente fra API -en.

Som vi beskrev tidligere, avhengig av hvilken type API du kobler til, kan det hende du må gi et unikt godkjenningstoken også i forespørselstittelen. Leverandøren gir vanligvis dette.

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

API -forespørsel

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

hvordan bytte harddisk fra skrivebeskyttet mac

API -svar

Et svar er det et API sender tilbake hver gang det 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 din.

Når du får svar fra et API, kan du betrakte API -samtalen som en suksess.

Slik bruker du APIer: Praktiske eksempler

Nå som du kjenner det grunnleggende i APIer og hva du trenger for å integrere en. Ta en titt på hvordan du kobler til og integrerer et fotballspådom -API fra RapidAPI bruker Python nedenfor.

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

I slekt: Slik kjører du Python -skriptet

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

import requests
endpoint = 'https://football-prediction-api.p.rapidapi.com/api/v2/predictions'
queryparams = {'market':'classic','iso_date':'2021-01-01','federation':'UEFA'}
#Define the request header:
headers = {
'x-rapidapi-key': 'Paste your access key here',
'x-rapidapi-host': 'football-prediction-api.p.rapidapi.com'
}
#Define the response header:
response = requests.request('GET', endpoint, headers=headers, params=queryparams)
#Get the response:
print(response.text)

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

Hva med å få gjeldende temperatur og fuktighet på et sted Weatherstack API med Python? Her er et eksempel nedenfor:

import requests
endpoint = 'http://api.weatherstack.com/current'
headers = {
'access_key': 'Paste your access key here',
'query': 'California'
}
req = requests.get(endpoint, headers)
res = req.json()
print(u'Current temperature in %s is %d℃' %
(res['location']['name'], res['current']['temperature']))
print(u'Current humidity in %s is %d℃' %
(res['location']['name'], res['current']['humidity']))

Typer APIer som du kan integrere

Open-source API-er er gratis, og alle kan bruke dem. Interne API -er befinner seg i en organisasjon, og bare apper som tilhører organisasjonen kan bruke ressursene.

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

Disse API-ene, unntatt åpen kildekode og interne API-er, kan komme til en pris, noen ganger fra hundrevis til tusenvis av dollar.

Forenkle apputvikling med APIer

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

Dele Dele kvitring E -post Hvordan APIer fungerer og hvordan de integreres i appen din

Å bruke programmeringsgrensesnitt (API) er en viktig ferdighet for alle programmerere å mestre.

Les neste
Relaterte temaer
  • Programmering
  • Programmering
  • BRANN
  • Sjargong
  • Kodetips
Om forfatteren Idisou Omisola(94 artikler publisert)

Idowu brenner for alt smart teknologi og produktivitet. På fritiden leker han med koding og bytter til sjakkbrettet når han kjeder seg, men han liker også å bryte fra rutinen en gang i blant. Hans lidenskap for å vise folk veien rundt moderne teknologi motiverer ham til å skrive mer.

Mer fra Idowu Omisola

Abonner på vårt nyhetsbrev

Bli med i vårt nyhetsbrev for tekniske tips, anmeldelser, gratis ebøker og eksklusive tilbud!

Klikk her for å abonnere