Mitä API tarkoittaa? Esimerkkejä sovellusliittymien käytöstä

Mitä API tarkoittaa? Esimerkkejä sovellusliittymien käytöstä

API on lyhenne sanoista Application Programming Interface. Ja vaikka tämä saattaa kuulostaa oudolta, jos olet uusi ohjelmoija, ne on helppo ymmärtää, kun rikkoo sen. Käytät niitä jopa päivittäin, kun käytät matkapuhelinta, tietokonetta tai selaat Internetiä.





Ohjelmistot, mukaan lukien verkkosovellukset, mobiilisovellukset ja monet muut ohjelmat, yhdistävät maailman Internetin kautta. Mutta jotta tämä olisi tehokkaampaa, tämän ohjelmiston välillä on oltava viestintäkanava - silloin API tulee sisään.



Tässä selitämme sovellusliittymien merkityksen ja niiden käytön.





Mikä on API?

Tiedätkö, miten voit katsella videoita muun muassa streaming -alustoilla, kuten Netflix ja YouTube? Se on mahdollista, koska lähetät pyynnön sovellusliittymän kautta.

Tai oletko kuvitellut, kuinka voit maksaa tavaroista, jotka ostat verkkokaupoista, kuten Amazon ja eBay? Tämä johtuu myös siitä, että pankkisi ja ostosovellusten välillä on sovellusliittymänä tunnettu viestintäkanava.



Sovellusliittymä on kuitenkin rajapinta, jossa on joukko sääntöjä, joiden avulla sovelluksesi palvelin voi olla vuorovaikutuksessa ratkaisuntarjoajan palvelimen kanssa, jotta voit käyttää niiden resursseja. Pohjimmiltaan se määrittää, miten sovellukset tai ohjelmistot kommunikoivat keskenään.

Joissakin tapauksissa sovellusliittymä mahdollistaa kuitenkin keskinäisen tiedonvaihdon. Esimerkki on yhteys pankkisovellusten ja verkkokauppasovellusten välillä.



API on kuin sanansaattaja. Se muodostaa yhteyden palveluntarjoajan palvelimeen toisessa päässä ja myös ankkuroi asiakkaan palvelimen toisessa päässä. Sitten se tarjoa asiakkaan pyynnön tietolähteelle (palveluntarjoajan palvelimelle) ja palauttaa vastauksen asiakkaalle. Asiakas on selain tai sovelluksesi.

Koukku kuitenkin liittää sovelluksesi sovellusliittymään. Se on API -päätepiste. Paljon asioita kuitenkin paljastuu kulissien takana. Selitämme näitä tarkemmin.



Miten sovellusliittymät auttavat sinua kehittämään sovelluksia nopeammin

Sovellusliittymät ovat älykkäämpi työkalu saumattomien ja kestävien sovellusten rakentamiseen. Ilman niitä kehittyneiden sovellusten luominen kestää vuosia.

Kuvittele, että tarvitset sovelluksesi monimutkaisten toimintojen suorittamiseen, ja sen rakentaminen vie paljon aikaa ja vaivaa. Ja sitten joku ilmestyy valmiilla ohjelmalla, joka tekee juuri sitä mitä haluat ja mahdollisesti paremmin.

kuinka mykistää sanat twitterissä

Mutta miten voit yhdistää tämän sovellukseesi? Palveluntarjoaja, joka ymmärsi tämän, saattaa antaa sinulle vaikeuksia, ja kertoi sitten, että he ovat luoneet yhteysrajapinnan (API), joka tekee heidän ja sinun koodisi integroiduiksi saumattomasti.

Tämä rajapinta (API) muodostaa yhteyden palvelimeen, joka sisältää heidän koodinsa. Sitten se syöttää sinulle takaisin tarvittavat tiedot heidän komentosarjansa toiminnasta.

Tietenkään et halua kyllästyä koko lähdekoodinsa kanssa. Lisäksi useimmat nykyaikaiset sovellusliittymät perustuvat nyt standardoituun REST -tekniikkaan (representational State Transfer). Se tekee niistä erittäin skaalautuvia ja helppoja integroida ilman, että sinun on huolehdittava siitä, mitä sisälläsi tapahtuu, tai vastauksesi tai pyyntösi tilasta, kun ne on muotoiltu valmiiksi.

Tässä artikkelissa ei selitetä tarkemmin REST -sovellusliittymää. Keskity nyt perusasioihin.

Koodin liittäminen omiinsa on parempi idea kuin kirjoittaa se alusta. Tätä varten sinun on kuitenkin kytkettävä koodisi niiden tarjoamaan sovellusliittymään. Miten teet tämän? Siinä API -päätepiste tulee kohtaukseen.

Mikä on API -päätepiste?

Asioiden yksinkertaistamiseksi palveluntarjoajat asettivat sitten URL -osoitteen, joka tekee yhteyden niiden sovellusliittymään saumattomaksi. Tällainen URL -osoite on API -päätepiste . Sen avulla sovelluksesi voi käyttää palvelintaan sovellusliittymän kautta ja kommunikoida suoraan komentosarjan kanssa.

Joten sinun tarvitsee vain napata päätepiste, liittää se koodiin, tehdä pyyntöjä sen kanssa, muokata vastauksia ja sitten se toimii, ja se on sinun! Siksi sovellusliittymän päätepiste sitoo sovelluksesi sovellusliittymän kautta ratkaisuun tai tietolähteeseen.

Loppujen lopuksi monet ohjelmointirajapintoja tarjoavat ohjelmat ovat saatavilla eri ohjelmointikielillä, jotta ketään ei estetä hyödyntämästä niitä.

Näin voit koodata nopeammin ja tehokkaammin tietäen, että sovellusliittymän ylläpitäminen ei ole sinun, vaan tietojen tai ratkaisujen tarjoajien vastuulla.

Siksi API -päätepiste on viestintäkoukku, joka sitoo sovellusliittymän resurssipalvelimeen toisesta reunasta ja yhdistää sen vastaanottimen palvelimeen toisessa päässä.

Tämä tarkoittaa sitä, että et tarvitse käyttämääsi ratkaisun koko komentosarjaa. Mutta koodisi ei voi muodostaa yhteyttä sen kanssa, jos se ei muodosta yhteyttä sovellusliittymän päätepisteeseen.

API -integrointisäännöt

Sovellusliittymän integrointiin ei ole kovia sääntöjä. Niitä on paljon, ja jokaisella on omat integrointisäännöt. Mutta pidä mielessä, että odotat a vastaus aina, kun muodostat yhteyden sovellusliittymään.

Pyyntöjen tekeminen sovellusliittymän päätepisteen kautta perustuu yleensä palveluntarjoajan määrittämiin sääntöihin, mutta mitä teet saamallasi vastauksella, riippuu mieltymyksistäsi. Pohjimmiltaan voit kiertää sitä haluamallasi tavalla vastaamaan sovelluksesi käyttäjien kokemuksia ja käyttöliittymää.

Joskus tarvitset myös todentajan, ennen kuin voit käyttää sovellusliittymää. Tällaiset todentajat tulevat yleensä käyttöoikeustunnuksina tai API -avaimina. Kun tämä merkki on läpäissyt todennustestin, sovellusliittymä ilmoittaa päätepisteelleen muodostaakseen yhteyden sovelluksesi ja palveluntarjoajan palvelimen välille.

Sovellusliittymän kuluttajana sinun ei tarvitse huolehtia näistä parametreista, koska sovellusliittymän tarjoaja asettaa ne saataville. Suuren sovellusliittymän pitäisi myös ilmoittaa, miten voit käyttää ja käyttää sen resursseja sen asiakirjoissa. Joten varo sitä aina, kun yrität integroida sen.

Pyöristääksesi sen ylöspäin, API -puhelu on kyse otsikot , an päätepiste , pyyntö , ja vastaus tai vartalo .

Vaikka olemme selittäneet, mikä on päätepiste, jakakaamme nämä muut termit edelleen:

Otsikot

Yleensä sinun on kuvattava kaksi otsikkomuotoa, kun muodostat yhteyden sovellusliittymään: pyyntö ja vastaus otsikot.

The pyynnön otsikko on API -puhelun yhdyskäytävä. Se kuvaa asiakkaan lähestymistapaa resurssin käyttöön. Se saattaa sisältää yksityiskohtia, kuten hyväksyttävän yhteystyypin, välityspalvelintiedot ja tietotyypin (JSON, XML tai HTML), jonka haluat saada sovellusliittymästä.

Kuten aiemmin kuvailimme, saatat joutua antamaan yksilöllisen todennustunnuksen pyynnön otsikossa sen mukaan, minkä tyyppisestä sovellusliittymästä muodostat yhteyden. Palveluntarjoaja yleensä antaa tämän.

The vastauksen otsikko toisaalta on väite palveluntarjoajan palvelimelta tulevista tiedoista. Se antaa sovelluksellesi tietoja palveluntarjoajan ominaisuuksista. Pohjimmiltaan se varmistaa, että sovelluksesi sallii pääsyn sovellusliittymästä tulevaan vastaukseen.

API -pyyntö

API -pyyntö sisältää yleensä päätepisteen URL -osoitteessa (Unique Resource Locator). Se etsii HTTP: n (Hypertext Transfer Protocol) avulla resurssin osoitteen, jota yrität käyttää API: n avulla. Lopulta sovellusliittymäpyyntö ei ole täydellinen, jos et sisällytä päätepistettä URL -osoitteeseen.

kuinka käyttää usb -muistitikkua

API -vastaus

Vastaus on se, jonka sovellusliittymä lähettää takaisin aina, kun se saa sovelluksestasi pyynnön. Se voi olla JSON, XML tai HTML, riippuen tiedoista tai sisältötyypistä, jotka se saa pyyntösi otsikosta.

Kun olet saanut vastauksen sovellusliittymästä, voit pitää API -kutsua onnistuneena.

Sovellusliittymien käyttö: Käytännön esimerkkejä

Nyt kun tiedät sovellusliittymien perusteet ja mitä tarvitset niiden yhdistämiseen. Katso, miten voit yhdistää ja integroida jalkapallon ennusteliittymän RapidAPI käyttämällä alla olevaa Pythonia.

Se on yksinkertainen sovellusliittymäpuhelu, joka palauttaa JSON -vastauksen. Voit myös kirjoittaa koodisi mihin tahansa tekstieditoriin ja suorittaa sen komentorivin kautta.

Aiheeseen liittyviä: Kuinka ajaa Python -komentosarja

Kiinnitä kuitenkin huomiota päätepisteeseen, pyyntöotsikoiden sisältöön ja vastausotsikoihin:

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)

Jatka oppimista: Kuinka käyttää IPStack -sovellusliittymää IP -maantieteellisiin paikannuksiin

Entä kuinka saada nykyisen lämpötilan ja kosteuden käyttämällä Weatherstack API Pythonin kanssa? Tässä on esimerkki alla:

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']))

Integroitavien sovellusliittymien tyypit

Avoimen lähdekoodin sovellusliittymät ovat ilmaisia, ja kuka tahansa voi käyttää niitä. Sisäiset sovellusliittymät sijaitsevat organisaatiossa, ja vain kyseiseen organisaatioon kuuluvat sovellukset voivat käyttää sen resursseja.

Voit kuitenkin valita myös erillisen sovellusliittymän tekemällä kumppanuussopimuksen palveluntarjoajan kanssa. Tai voit yhdistää useita sovellusliittymiä ratkaistaksesi erilaisia ​​ongelmia.

Myös nämä sovellusliittymät, lukuun ottamatta avoimen lähdekoodin ja sisäisiä sovellusliittymiä, voivat tulla hinnoiksi, jotka vaihtelevat joskus sadoista tuhansiin dollareihin.

Yksinkertaista sovellusten kehittämistä sovellusliittymien avulla

Kuten huomaat, sinun ei tarvitse enää kirjoittaa aikaa vievää koodia. Jos tarvitset sovelluksesi monimutkaisten toimintojen suorittamiseen, voit aina hakea sieltä ja napata sopivan sovellusliittymän. Onneksi ne on nyt jopa helppo integroida kuin vanhat perinteiset. Ja jos olet utelias ja haluat tietää enemmän, siellä on monia ilmaisia ​​sovellusliittymiä, jotka voivat auttaa sinua saamaan kätesi likaiseksi.

Jaa Jaa Tweet Sähköposti Miten sovellusliittymät toimivat ja miten ne voidaan integroida sovellukseesi

Sovellusohjelmointirajapintojen (API) käyttö on olennainen taito kaikille ohjelmoijille.

Lue seuraava Liittyvät aiheet
  • Ohjelmointi
  • Ohjelmointi
  • ANTAA POTKUT
  • Jargon
  • Koodausvinkkejä
Kirjailijasta Idisou Omisola(94 artikkelia julkaistu)

Idowu on intohimoinen kaikkeen älykkääseen tekniikkaan ja tuottavuuteen. Vapaa -ajallaan hän leikkii koodauksella ja vaihtaa shakkilaudalle, kun on kyllästynyt, mutta hän myös rakastaa irtautumista rutiinista silloin tällöin. Hänen intohimonsa näyttää ihmisille tie modernin tekniikan ympärillä motivoi häntä kirjoittamaan enemmän.

Lisää Idowu Omisolasta

tilaa uutiskirjeemme

Liity uutiskirjeeseemme saadaksesi teknisiä vinkkejä, arvosteluja, ilmaisia ​​e -kirjoja ja ainutlaatuisia tarjouksia!

Klikkaa tästä tilataksesi