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

API tarkoittaa "Application Programming Interface". Ja vaikka tämä saattaa kuulostaa oudolta, jos olet uusi ohjelmoija, ne on helppo ymmärtää, kun hajotat sen. Voit käyttää niitä jopa päivittäin käyttäessäsi matkapuhelinta, tietokonetta tai selatessasi Internetiä.

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

Tässä kerromme sovellusliittymien merkityksestä ja niiden käytöstä.

Mikä on API?

Tiedätkö kuinka pystyt näkemään videoita muun muassa suoratoistoalustoilla, kuten Netflix ja YouTube? Se on mahdollista, koska lähetät pyynnön sovellusliittymän kautta.

Vai oletko kuvitellut, kuinka pystyt maksamaan tavaroista, jotka ostat verkkokaupoista, kuten Amazon ja eBay? Tämä johtuu myös siitä, että pankkisi ja ostosovellusten välillä on viestintäkanava, joka tunnetaan API: na.

API on käyttöliittymä, jossa on joukko sääntöjä, joiden avulla sovelluksesi palvelin voi olla vuorovaikutuksessa ratkaisun tarjoajan palvelimen kanssa, jotta voit käyttää heidän resurssejaan. Pohjimmiltaan se määrittää, miten sovellukset tai ohjelmistot kommunikoivat keskenään.

Joissakin tapauksissa API kuitenkin sallii keskinäisen tiedonvaihdon. Esimerkki on yhteys, joka on olemassa pankkisovellusten ja verkkokauppasovellusten välillä.

API on kuin Messenger. Se muodostaa yhteyden palveluntarjoajan palvelimeen toisessa päässä ja myös ankkuroi asiakkaan palvelimen toiseen päähän. Sitten se huutaa 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 etenee kuitenkin kulissien takana. Selitämme nämä tarkemmin.

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

API: t ovat älykkäämpi työkalu saumattomien ja kestävien sovellusten rakentamiseen. Ilman heitä kehittyneiden sovellusten rakentaminen veisi aikoja.

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

Mutta kuinka voit yhdistää tämän sovellukseesi? Palveluntarjoaja ymmärtäen, että tämä saattaa antaa sinulle jonkin aikaa, kertoi sitten, että he loivat yhteysliittymän (API), joka saa koodin ja sinun integroitumaan saumattomasti.

Tämä käyttöliittymä (API) muodostaa yhteyden palvelimeen, joka sisältää heidän koodinsa. Sitten se antaa sinulle takaisin asiaankuuluvat tiedot heidän komentosarjan toiminnasta.

Et tietenkään halua kyllästyä koko lähdekoodiin. Lisäksi suurin osa moderneista sovellusliittymistä perustuu nyt standardoituun REST (Representational State Transfer) -tekniikkaan. Se tekee niistä erittäin skaalautuvat ja helposti integroitavat ilman, että sinun on huolehdittava vastauksen tai pyynnön tilasta, kun ne on alustettu.

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

Koodin liittäminen omiin on parempi idea kuin kirjoittaa se tyhjästä. Voit tehdä sen kuitenkin liittämällä koodisi heidän toimittamaansa sovellusliittymään. Miten teet tämän? Siellä kohtaukseen tulee API-päätepiste.

Mikä on API-päätepiste?

Yksinkertaistamiseksi palveluntarjoajat asettivat sitten URL-osoitteen, jotta yhteyden muodostaminen sovellusliittymään saumattomasti. Tällainen URL on API-päätepiste. Sen avulla sovelluksesi voi sitten käyttää palvelinta API: n kautta ja olla yhteydessä suoraan komentosarjaansa.

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

Viime kädessä monet sovellusliittymiä tarjoavista ohjelmista ovat saatavana useilla ohjelmointikielillä, joten kukaan ei jää ulkopuolelle hyötymästä niistä.

Tällä tavalla pääset koodaamaan nopeammin ja tehokkaammin, kun tiedät, että API: n ylläpitäminen ei ole sinun, vaan tietojen tai ratkaisujen tarjoajien vastuulla.

Siksi API-päätepiste on tietoliikennekoukku, joka sitoo API: n resurssipalvelimeen yhdestä reunasta ja yhdistää sen vastaanottimen palvelimeen toisessa päässä.

Se tarkoittaa sitten, ettet tarvitse koko ratkaisun komentosarjaa, jota haluat käyttää. Koodisi ei kuitenkaan voi muodostaa yhteyttä siihen, jos se ei muodosta yhteyttä API-päätepisteeseensä.

API-integrointisäännöt

API: n integroimiseksi ei ole kovaa sääntöä. Heitä on siellä paljon, ja jokaisella on integrointisäännöt. Mutta pidä mielessä, että odotat vastaus aina kun muodostat yhteyden sovellusliittymään.

Kuinka teet pyyntöjä API-päätepisteen kautta, perustuu yleensä palveluntarjoajan määrittelemiin sääntöihin, mutta mitä teet saamallasi vastauksella, riippuu mieltymyksistäsi. Pohjimmiltaan voit kiertää sitä haluamallasi tavalla sovelluksesi käyttäjien kokemusten ja käyttöliittymän mukaiseksi.

Joskus tarvitset myös todennuksen, ennen kuin voit käyttää sovellusliittymää. Tällaiset todentajat tulevat yleensä pääsykoodeina tai API-avaimina. Kun tämä tunnus on läpäissyt todennustestin, sovellusliittymä ilmoittaa päätepisteestään yhteyden muodostamiseksi sovelluksesi ja palveluntarjoajan palvelimen välille.

API-kuluttajana sinun ei tarvitse huolehtia näistä parametreista, koska API-palveluntarjoaja tarjoaa ne saataville. Hienon sovellusliittymän tulisi myös ilmoittaa, kuinka voit käyttää sen resursseja ja käyttää sen dokumentaatiota. Joten varo aina sitä yrittäessäsi integroida yksi.

Pyöristääksesi sen, API-kutsu on kyse otsikot, an päätepiste, pyyntö, ja vastaus tai runko.

Vaikka olemme selittäneet, mitä päätetapahtuma on, erittelemme nämä muut termit edelleen:

Otsikot

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

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ä yhteystyyppi, välityspalvelintiedot ja tietotyyppi (JSON, XML tai HTML), jonka haluat saada sovellusliittymältä.

Kuten kuvasimme aiemmin, joudut ehkä tarjoamaan yksilöllisen todennustunnuksen pyynnön otsikossa sen mukaan, minkä tyyppiseen sovellusliittymään olet yhteydessä. Palveluntarjoaja antaa tämän yleensä.

vastauksen otsikkoon toisaalta vakuutus palveluntarjoajan palvelimelta tulevista tiedoista. Se antaa sovelluksellesi tietoja palveluntarjoajan ominaisuuksista. Pohjimmiltaan se varmistaa, että sovelluksesi myöntää 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: lla. Viime kädessä API-pyyntö ei ole täydellinen, jos et sisällytä päätepistettä URL-osoitteeseen.

API-vastaus

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

Kun saat vastauksen sovellusliittymältä, voit pitää API-puhelua onnistuneena.

Kuinka käyttää sovellusliittymiä: Käytännön esimerkkejä

Nyt kun tiedät sovellusliittymien perusteet ja mitä sinun on integroitava. Katso, miten voit yhdistää ja integroida jalkapalloennusteen sovellusliittymän RapidAPI käyttämällä alla olevaa Pythonia.

Se on yksinkertainen API-kutsu, joka palauttaa JSON-vastauksen. Voit myös kirjoittaa koodisi sisään mikä tahansa tekstieditorija suorita se komentorivin kautta.

Liittyvät: Kuinka suorittaa Python-komentosarjasi

Kiinnitä kuitenkin tarkkaa huomiota päätepisteeseen, pyynnön otsikkojen ja vastausten otsikoiden sisältöön:

tuontipyynnöt
päätepiste = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
#Määritä pyynnön otsikko:
otsikot = {
'x-rapidapi-key': "Liitä käyttöavaimesi tähän",
'x-rapidapi-host': "jalkapalloennuste-api.p.rapidapi.com"
}
#Define vastausotsikko:
vastaus = request.request ("GET", päätepiste, otsikot = otsikot, parametrit = kyselyparametrit)
#Saa vastaus:
tulosta (vastaus.teksti)

Jatka oppimista: IPStack-sovellusliittymän käyttäminen IP-sijaintihakuihin

Entä saada paikan nykyinen lämpötila ja kosteus käyttämällä Weatherstack-sovellusliittymä Pythonin kanssa? Tässä on esimerkki alla:

tuontipyynnöt
päätepiste = ' http://api.weatherstack.com/current'
otsikot = {
"access_key": "Liitä pääsyavaimesi tähän",
"query": "Kalifornia"
}
req = request.get (päätepiste, otsikot)
res = req.json ()
tulosta (u "Nykyinen lämpötila% s on% d ℃"% 
(res ["sijainti"] ["nimi"], res ["nykyinen"] ["lämpötila"]))
tulosta (u "Nykyinen kosteus% s on% d ℃"% 
(res ["sijainti"] ["nimi"], res ["nykyinen"] ["kosteus"]))

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 siihen 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ä erilaisten ongelmien ratkaisemiseksi.

Lisäksi näillä sovellusliittymillä, lukuun ottamatta avoimen lähdekoodin ja sisäisiä sovellusliittymiä, voi olla hinta, joka voi joskus vaihdella satoista tuhansiin dollareihin.

Yksinkertaista sovelluskehitystä sovellusliittymien avulla

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

Kuinka sovellusliittymät toimivat ja miten ne voidaan integroida sovellukseesi

Sovellusohjelmointirajapintojen (API) käyttö on välttämätön taito kaikille ohjelmoijille hallita.

Lue seuraava

Kirjailijasta