Mida tähendab API? Näiteid API -de kasutamise kohta

Mida tähendab API? Näiteid API -de kasutamise kohta

API tähistab 'Application Programming Interface'. Ja kuigi see võib tunduda kummaline, kui olete programmeerimisega alles kursis, on neid pärast lagunemist lihtne mõista. Kasutate neid isegi iga päev mobiiltelefoni, arvuti või Interneti sirvimise ajal.





Tarkvara, sealhulgas veebirakendused, mobiilirakendused ja paljud teised programmid ühendavad maailma Interneti kaudu. Kuid selle tõhusamaks muutmiseks peab selle tarkvara vahel olema suhtluskanal - see on koht, kus API tuleb sisse.





Siin selgitame API -de tähendust ja nende kasutamist.





Mis on API?

Kas teate, kuidas saate vaadata videoid muu hulgas voogesitusplatvormidel nagu Netflix ja YouTube? See on võimalik, kuna saadate taotluse API kaudu.

Või kas olete ette kujutanud, kuidas saate maksta veebipoodidest nagu Amazon ja eBay ostetud kaupade eest? Seda ka seetõttu, et teie panga ja osturakenduste vahel on olemas API -ks tuntud suhtluskanal.



Sellegipoolest on API liides reeglite kogumiga, mis võimaldab teie rakenduse serveril suhelda lahenduste pakkuja serveriga, et saaksite nende ressursse kasutada. Sisuliselt määratleb see, kuidas rakendused või tarkvara omavahel suhtlevad.

Mõnel juhul võimaldab API siiski vastastikust andmevahetust. Näitena võib tuua teie pangarakenduste ja veebipoe rakenduste vahelise ühenduse.





API on nagu sõnumitooja. See ühendub teenusepakkuja serveriga ühes otsas ja kinnitab ka kliendi serveri teises otsas. Seejärel saadab see kliendi päringu andmeallikale (teenusepakkuja server) ja tagastab kliendile vastuse. Siin on klient brauser või teie rakendus.

Konks aga kinnitab teie rakenduse API -ga. See on API lõpp -punkt. Kaadri taga rullub aga palju asju lahti. Me selgitame neid veelgi.





Kuidas API -d aitavad teil rakendusi kiiremini arendada

API -d on nutikam tööriist sujuvate ja jõuliste rakenduste loomiseks. Ilma nendeta võtaks keerukate rakenduste loomine aega.

Kujutage ette, et vajate oma rakendust keerukate toimingute tegemiseks, mille loomiseks kulub palju aega ja vaeva. Ja siis ilmub keegi valmis programmiga, mis teeb täpselt seda, mida soovite, ja võib-olla paremini.

topeltkäivitus Windows 10 ja linux

Aga kuidas saate selle oma rakendusega ühendada? Teenusepakkuja, mõistes seda, võib teile raskusi anda, ja ütles teile, et lõid ühendusliidese (API), mis muudab nende ja teie koodi sujuvalt integreerituks.

See liides (API) ühendub serveriga, mis sisaldab nende koodi. Seejärel saadab see teile tagasi skripti toimingute asjakohased andmed.

Loomulikult ei taha te kogu nende lähteskriptiga igavleda. Pealegi toetub enamik tänapäevaseid API -sid standardiseeritud REST (representational State Transfer) tehnoloogiale. See muudab need väga skaleeritavaks ja hõlpsasti integreeritavaks, ilma et peaksite muretsema selle pärast, mis toimub teie vastuses või taotluses, kui need on eelvormindatud.

See artikkel ei lähe REST API selgitamiseks kaugemale. Keskenduge praegu põhitõdedele.

Koodi ühendamine nende omaga on parem mõte kui selle nullist kirjutamine. Selleks peate aga oma koodi ühendama nende pakutud API -ga. Kuidas seda teha? Siin tuleb stseeni API lõpp -punkt.

Mis on API lõpp -punkt?

Asjade lihtsustamiseks panid teenusepakkujad seejärel URL -i üles, et muuta oma API -ga ühenduse loomine sujuvaks. Selline URL on API lõpp -punkt . Sellega pääseb teie rakendus API kaudu oma serverile juurde ja saab oma skriptiga otse suhelda.

Nii et kõik, mida peate tegema, on haarata lõpp -punkt, kleepida see oma koodi, esitada sellega päringuid, kohandada vastuseid ja siis see töötab ja see on teie! Seetõttu seob API lõpp -punkt teie rakenduse API kaudu lahenduse või andmeallikaga.

Lõppkokkuvõttes on paljud API -sid pakkuvad programmid saadaval erinevates programmeerimiskeeltes, nii et keegi ei saaks neist kasu saada.

Nii saate kiiremini ja tõhusamalt kodeerida, teades, et API hooldamise kohustus ei ole teie, vaid andmete või lahenduste pakkujad.

Seetõttu on API lõpp -punkt suhtluskonks, mis seob API ühest servast ressursiserveriga ja ühendab selle vastuvõtja serveriga teises otsas.

See tähendab, et te ei vaja kogu soovitud lahenduse skripti. Kuid teie kood ei saa sellega ühendust luua, kui see ei loo ühendust oma API lõpp -punktiga.

API integreerimise reeglid

API integreerimiseks pole ranget reeglit. Neid on seal palju ja igal neist on oma integratsioonireeglid. Kuid pidage meeles, et ootate a vastus iga kord, kui loote ühenduse API -ga.

See, kuidas te taotlusi API lõpp-punkti kaudu esitate, põhineb tavaliselt pakkuja määratud reeglitel, kuid see, mida te vastusega saate, sõltub teie eelistustest. Põhimõtteliselt saate seda oma rakenduse kasutajate kogemuste ja liidese järgi kohandada.

Mõnikord vajate ka API -le juurdepääsu saamiseks autentimist. Sellised autentijad on tavaliselt juurdepääsulubadena või API -võtmetena. Kui see luba läbib autentimistesti, annab API seejärel märku oma lõpp -punktist, et luua ühendus teie rakenduse ja teenusepakkuja serveri vahel.

API tarbijana ei pea te nende parameetrite pärast muretsema, sest API pakkuja teeb need kättesaadavaks. Suurepärane API peaks ka näitama, kuidas saate selle dokumentidele juurde pääseda ja neid kasutada. Nii et olge selle integreerimisel alati tähelepanelik.

Ümardamiseks on API -kõne seotud päiseid , an lõpp -punkt , taotlus , ja vastus või keha .

Kuigi oleme selgitanud, mis on lõpp -punkt, jagame need muud terminid veelgi:

Päised

Tavaliselt peate API -ga ühenduse loomisel kirjeldama kahte päiste vormi: taotlus ja vastus päiseid.

The päringu päis on API kõne lüüs. See kirjeldab kliendi lähenemisviisi ressursile juurdepääsuks. See võib üksikasjalikult kirjeldada selliseid asju nagu vastuvõetav ühenduse tüüp, puhverserveri teave ja andmetüüp (JSON, XML või HTML), mida soovite API -lt saada.

Nagu me varem kirjeldasime, peate võib -olla taotluse päises esitama unikaalse autentimismärgi, sõltuvalt ühenduse tüübist, millega ühendate. Tavaliselt pakub seda teenusepakkuja.

The vastuse päis seevastu on pakkuja serverist pärinevate andmete kinnitamine. See annab teie rakendusele teavet pakkuja omaduste kohta. Sisuliselt tagab see, et teie rakendus annab juurdepääsu API -lt tulevale vastusele.

API taotlus

API taotlus sisaldab tavaliselt URL -is (Unique Resource Locator) lõpp -punkti. See kasutab hüperteksti edastusprotokolli (HTTP), et leida ressursi aadress, millele proovite API -ga juurde pääseda. Lõppkokkuvõttes pole API taotlus täielik, kui te ei sisalda URL -i lõpp -punkti.

stoppkood: süsteemi lõime erandit ei käsitleta

API vastus

Vastus on see, mille API saadab tagasi iga kord, kui saab teie rakendusest päringu. See võib olla JSON, XML või HTML, sõltuvalt teie päringu päisest saadud andmetest või sisutüübist.

Kui olete API -lt vastuse saanud, võite lugeda oma API -kõne edukaks.

API -de kasutamine: praktilised näited

Nüüd, kui teate API -de põhitõdesid ja nende integreerimiseks vajalikku. Vaadake, kuidas ühendada ja integreerida jalgpalliprognooside API RapidAPI kasutades allpool olevat Pythoni.

See on lihtne API -kõne, mis tagastab JSON -i vastuse. Samuti saate oma koodi kirjutada mis tahes tekstiredaktoris ja käivitada selle käsurealt.

Seotud: Kuidas oma Pythoni skripti käivitada

Pöörake siiski suurt tähelepanu lõpp -punktile, päringu päiste ja vastuste päistele:

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)

Jätkake õppimist: kuidas kasutada IPStacki API -d geograafilise asukoha otsimiseks

Kuidas saada praeguse temperatuuri ja niiskuse kohta kasutades Weatherstack API Pythoniga? Siin on näide allpool:

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

Integreeritavate API -de tüübid

Avatud lähtekoodiga API-d on tasuta ja igaüks saab neid kasutada. Sisemised API -d asuvad organisatsioonis ja selle ressursse saavad kasutada ainult sellele organisatsioonile kuuluvad rakendused.

Siiski saate valida ka spetsiaalse API, sõlmides teenusepakkujaga partnerluslepingu. Või võite erinevate probleemide lahendamiseks kombineerida mitu API -d.

Samuti võivad need API-d, välja arvatud avatud lähtekoodiga ja sisemised API-d, olla hinnaga, ulatudes mõnikord sadadest tuhandetesse dollaritesse.

Lihtsustage rakenduste arendamist API -de abil

Nagu näete, ei pea te enam aeganõudvat koodi kirjutama. Kui vajate oma rakendust keerukate toimingute tegemiseks, saate alati otsida ja hankida asjakohase API. Õnneks on neid nüüd isegi lihtne integreerida kui vanu tavapäraseid. Ja kui olete uudishimulik ja soovite rohkem teada saada, on seal palju tasuta API -sid, mis aitavad teil käsi määrida.

Jaga Jaga Piiksuma E -post Kuidas API -d töötavad ja kuidas neid oma rakendusse integreerida

Rakenduste programmeerimisliideste (API) kasutamine on kõigi programmeerijate jaoks oluline oskus.

Loe edasi
Seotud teemad
  • Programmeerimine
  • Programmeerimine
  • Tuli
  • Žargon
  • Näpunäiteid kodeerimiseks
Autori kohta Idisou Omisola(Avaldatud 94 artiklit)

Idowu on kirglik kõige nutika tehnoloogia ja tootlikkuse vastu. Vabal ajal mängib ta kodeerimisega ja lülitab malelauale, kui tal on igav, kuid talle meeldib ka aeg -ajalt rutiinist lahti saada. Tema kirg näidata inimestele teed kaasaegses tehnoloogias motiveerib teda rohkem kirjutama.

Veel Idowu Omisolast

Telli meie uudiskiri

Liituge meie uudiskirjaga, et saada tehnilisi näpunäiteid, ülevaateid, tasuta e -raamatuid ja eksklusiivseid pakkumisi!

Tellimiseks klõpsake siin