Ano ang Paninindigan ng API? Mga halimbawa ng Paano Gumamit ng mga API

Ano ang Paninindigan ng API? Mga halimbawa ng Paano Gumamit ng mga API

Ang API ay nangangahulugang 'Application Programming Interface'. At habang ito ay maaaring kakaiba kung bago ka sa pag-program, madali silang maunawaan kapag pinaghiwalay mo ito. Ginagamit mo pa rin ang mga ito araw-araw habang pinapatakbo ang iyong mobile phone, PC, o habang nagba-browse sa internet.





Ang software, kabilang ang mga web app, mobile app, at maraming iba pang mga programa, na nag-uugnay sa mundo sa pamamagitan ng internet. Ngunit upang gawing mas mahusay ito, dapat mayroong isang channel ng komunikasyon sa pagitan ng software na ito — doon pumapasok ang isang API.





Dito, ipapaliwanag namin ang kahulugan ng mga API at kung paano ito gamitin.





Ano ang isang API?

Alam mo ba kung paano mo nakikita ang mga video sa streaming platform tulad ng Netflix at YouTube bukod sa iba pa? Posible dahil nagpapadala ka ng isang kahilingan sa pamamagitan ng isang API.

O naisip mo ba kung paano mo mababayaran ang mga produktong bibilhin mo mula sa mga online store tulad ng Amazon at eBay? Dahil din doon sa isang channel ng komunikasyon na kilala bilang isang API sa pagitan ng iyong bangko at ng mga shopping app.



Sinabi nito, ang isang API ay isang interface na may isang hanay ng mga patakaran na nagpapahintulot sa server ng iyong app na makipag-ugnay sa server ng isang provider ng solusyon upang magamit mo ang kanilang mga mapagkukunan. Sa esensya, tinutukoy nito kung paano nakikipag-usap ang mga app o software sa bawat isa.

Sa ilang mga kaso, gayunpaman, pinapayagan ng isang API ang mutualistic data exchange. Ang isang halimbawa ay isang koneksyon na umiiral sa pagitan ng iyong mga app ng bangko at mga app ng online na tindahan.





Ang isang API ay tulad ng isang messenger. Kumokonekta ito sa server ng isang provider sa isang dulo at inaangkin din ang server ng kliyente sa kabilang dulo. Pagkatapos ay ihinahatid nito ang kahilingan ng kliyente sa pinagmulan ng data (server ng provider) at nagbabalik ng tugon sa kliyente. Ang isang client dito ay ang browser o ang iyong app.

Gayunpaman, ang isang kawit ay nakakabit ng iyong app sa API. Iyon ay isang endpoint ng API. Gayunpaman, maraming mga bagay ang naglalahad sa likod ng eksena. Ipapaliwanag namin ang mga ito nang higit pa.





Paano ka Matutulungan ng mga API na Bumuo ng Mga App Mas Mabilis

Ang mga API ay isang mas matalinong tool para sa pagbuo ng seamless at matatag na mga application. Kung wala ang mga ito, ang pagbuo ng mga sopistikadong apps ay tatagal ng edad.

Isipin na kailangan mo ang iyong app upang magsagawa ng mga kumplikadong pagpapatakbo, ang uri na tumatagal ng isang toneladang oras at pagsisikap na maitayo. At pagkatapos ay may magpapakita na may isang nakahandang programa na eksaktong ginagawa ang nais mo, at posibleng mas mabuti.

windows 10 na hindi kumokonekta sa wifi

Ngunit paano mo ito makokonekta sa iyong app? Ang provider, napagtanto na ito ay maaaring magbigay sa iyo ng ilang oras ng paghihirap, pagkatapos ay sinabi sa iyo na lumikha sila ng isang interface ng koneksyon (API) na gumagawa ng kanilang code at sa iyo nang maisama nang walang putol.

Ang interface na iyon (API) ay kumokonekta sa server na naglalaman ng kanilang code. Pagkatapos ay ibabalik ka nito sa nauugnay na data mula sa pagkilos ng kanilang script.

Siyempre, hindi mo nais na maipanganak ang iyong sarili sa kanilang buong script ng pinagmulan. Bukod, ang karamihan sa mga modernong API ngayon ay umaasa sa standardized na teknolohiya ng REST (Representational State Transfer). Ginagawa itong lubos na nasusukat at madaling maisama, nang hindi mo kailangang mag-alala tungkol sa kung ano ang lumilitaw sa loob o ng estado ng iyong tugon o kahilingan habang sila ay preformatted.

Ang artikulong ito ay hindi na magpapatuloy sa pagpapaliwanag ng REST API. Ituon ang mga pangunahing kaalaman sa ngayon.

Ang paglalagay ng iyong code sa kanila ay isang mas mahusay na ideya kaysa sa pagsusulat nito mula sa simula. Gayunpaman, upang gawin iyon, kailangan mong i-hook ang iyong code sa API na ibinigay nila. Paano mo ito ginagawa? Doon dumating ang isang endpoint ng API.

Ano ang isang Endpoint ng API?

Upang gawing simple ang mga bagay, naglalagay ang mga provider ng isang URL upang gawing seamless ang pagkonekta sa kanilang API. Ang nasabing URL ay isang Endpoint ng API . Gamit ito, maaaring ma-access ng iyong app ang kanilang server sa pamamagitan ng API at direktang makipag-usap sa kanilang script.

Kaya ang kailangan mo lang gawin ay kunin ang endpoint, i-paste ito sa iyong code, gumawa ng mga kahilingan kasama nito, ipasadya ang mga tugon, at pagkatapos, gumagana ito, at iyo ito! Samakatuwid, ang isang endpoint ng API ay nagbubuklod sa iyong app sa pamamagitan ng isang API sa isang solusyon o mapagkukunan ng data.

Sa huli, marami sa mga program na nag-aalok ng mga API ay magagamit sa iba't ibang mga wika ng programa upang walang sinuman ang maibukod mula sa makikinabang mula sa kanila.

Sa ganoong paraan, makakakuha ka ng mas mabilis at mas mahusay na pag-code, nalalaman na ang gawain ng pagpapanatili ng API ay hindi sa iyo ngunit ang mga nagbibigay ng data o solusyon.

Samakatuwid, ang isang endpoint ng API ay isang hook ng komunikasyon na nagbubuklod sa isang API sa isang mapagkukunang server sa isang gilid at ikinonekta ito sa server ng tatanggap sa kabilang dulo.

Nangangahulugan ito pagkatapos na hindi mo kailangan ang buong script ng solusyon na nais mong gamitin. Ngunit hindi maitatag ng iyong code ang komunikasyon dito kung hindi ito nakakakonekta sa endpoint ng API nito.

Mga Panuntunan sa Pagsasama ng API

Walang mahirap na panuntunan para sa pagsasama ng isang API. Mayroong isang tonelada ng mga ito doon, at bawat isa sa kanila ay may mga panuntunan sa pagsasama. Ngunit isipin mo na umaasa ka a tugon tuwing magtataguyod ka ng isang koneksyon sa isang API.

Kung paano ka gumawa ng mga kahilingan sa pamamagitan ng isang endpoint ng API ay karaniwang batay sa mga patakaran na tinukoy ng provider, ngunit kung ano ang gagawin mo sa tugon na nakukuha mo ay nakasalalay sa iyong kagustuhan. Sa esensya, maaari mong i-twist ito hangga't gusto mong sumunod sa karanasan at interface ng mga gumagamit ng iyong app.

Minsan, kailangan mo rin ng isang authenticator bago mo ma-access ang isang API. Ang mga naturang authenticator ay karaniwang nagmumula bilang mga token sa pag-access o mga key ng API. Sa sandaling ang token na ito ay pumasa sa isang pagsubok sa pagpapatotoo, pagkatapos ay signal ng API ang endpoint nito upang magtaguyod ng isang koneksyon sa pagitan ng iyong app at server ng provider.

Bilang consumer ng API, hindi mo kailangang mag-alala tungkol sa mga parameter na ito dahil ginagamit sila ng provider ng API. Dapat ding sabihin ng isang mahusay na API kung paano mo maa-access at magagamit ang mga mapagkukunan nito sa dokumentasyon nito. Kaya't laging alagaan iyon kapag sinusubukang isama ang isa.

Upang maikot ito, ang isang tawag sa API ay tungkol sa mga header , isang endpoint , ang hiling , at ang tugon o ang katawan .

Habang ipinaliwanag namin kung ano ang isang endpoint, paghiwalayin natin ang iba pang mga term na ito:

Mga Header

Karaniwan, kailangan mong ilarawan ang dalawang anyo ng mga header habang kumokonekta sa isang API: ang hiling at ang tugon mga header.

Ang humiling ng header ay ang gateway ng isang tawag sa API. Inilalarawan nito ang diskarte ng isang kliyente sa pag-access ng isang mapagkukunan. Maaari itong idetalye ang mga bagay tulad ng katanggap-tanggap na uri ng koneksyon, impormasyon ng proxy, at ang uri ng data (JSON, XML, o HTML) na nais mong makuha mula sa API.

Tulad ng inilarawan namin kanina, depende sa uri ng API na iyong kumokonekta, maaari kang magbigay ng isang natatanging token ng pagpapatotoo sa loob ng header ng kahilingan din. Karaniwang ibinibigay ito ng provider.

Ang tugon header , sa kabilang banda, ay isang assertion ng data na nagmumula sa server ng provider. Nagbibigay ito ng impormasyon sa iyong app tungkol sa mga katangian ng isang provider. Sa katunayan, tinitiyak nito na ang iyong app ay nagbibigay ng pag-access sa tugon na nagmumula sa API.

Kahilingan sa API

Karaniwang naglalaman ang isang kahilingan sa API ng endpoint sa isang URL (Natatanging Tagahanap ng Mapagkukunan). Gumagamit ito ng Hypertext Transfer Protocol (HTTP) upang hanapin ang address ng mapagkukunang sinusubukan mong i-access sa isang API. Sa huli, isang kahilingan sa API ay hindi kumpleto kung hindi mo isasama ang endpoint sa URL.

kung paano maglaro ng laro sa apple tv

Tugon ng API

Ang isang tugon ay kung ano ang ibabalik ng isang API sa tuwing makakatanggap ito ng isang kahilingan mula sa iyong app. Maaari itong maging JSON, XML, o HTML, depende sa data o uri ng nilalaman na natatanggap nito mula sa iyong header ng kahilingan.

Kapag nakakuha ka ng isang tugon mula sa isang API, maaari mong isaalang-alang ang iyong API na tawag sa isang tagumpay.

Paano Gumamit ng mga API: Mga Praktikal na Halimbawa

Ngayon na alam mo na ang mga pangunahing kaalaman sa mga API at kung ano ang kailangan mo upang isama ang isa. Tingnan kung paano ikonekta at isama ang isang hula ng football API mula sa RapidAPI gamit ang Python sa ibaba.

Ito ay isang simpleng tawag sa API na nagbabalik ng tugon sa JSON. Maaari mo ring isulat ang iyong code sa anumang text editor, at patakbuhin ito sa pamamagitan ng linya ng utos.

Kaugnay: Paano Patakbuhin ang Iyong Python Script

Gayunpaman, bigyang-pansin ang endpoint, ang nilalaman ng mga header ng kahilingan at mga header ng tugon:

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)

Panatilihin ang Pag-aaral: Paano Gumamit ng IPStack API para sa Mga Paghahanap sa Geolocation ng IP

Paano ang tungkol sa pagkuha ng kasalukuyang temperatura at halumigmig ng isang lugar na ginagamit Weatherstack API kasama si Python? Narito ang isang halimbawa sa ibaba:

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

Mga uri ng API na Maaari Mong Isama

Ang mga open-source API ay libre, at sinuman ay maaaring gumamit ng mga ito. Ang mga panloob na API ay naninirahan sa loob ng isang samahan, at ang mga app na kabilang lamang sa organisasyong iyon ang maaaring gumamit ng mga mapagkukunan nito.

Gayunpaman, maaari ka ring pumili para sa isang nakalaang API sa pamamagitan ng pagpasok ng isang kasunduan sa pakikipagsosyo sa isang tagapagbigay. O maaari mong pagsamahin ang maraming mga API upang malutas ang iba't ibang mga problema.

Gayundin, ang mga API na ito, hindi kasama ang open-source at panloob na mga API, ay maaaring magkaroon ng presyo, kung minsan ay umaabot mula sa daan-daang hanggang libu-libong dolyar.

Pasimplehin ang Pag-unlad ng App Sa Mga API

Tulad ng nakikita mo, na hindi mo na kailangang magsulat ng matagal nang matagal na code. Kung kailangan mo ang iyong app upang magsagawa ng mga kumplikadong pagpapatakbo, maaari kang laging maghanap doon at kumuha ng isang nauugnay na API. Sa kabutihang palad, madali na rin silang isama kaysa sa mga dati nang maginoo. At kung gusto mong malaman at nais mong malaman ang higit pa, maraming mga libreng API doon na makakatulong sa iyo na madumi ang iyong mga kamay.

Magbahagi Magbahagi Mag-tweet Email Paano Gumagana ang mga API at Paano Maihatid ang mga Ito sa Iyong App

Ang paggamit ng mga interface ng application programming (API) ay isang mahalagang kasanayan para sa lahat ng mga programmer na makabisado.

Basahin Susunod
Mga Kaugnay na Paksa
  • Programming
  • Programming
  • APOY
  • Jargon
  • Mga Tip sa Coding
Tungkol sa May-akda Idisou Omisola(94 na artikulong nalathala)

Si Idowu ay madamdamin tungkol sa anumang matalinong tech at pagiging produktibo. Sa kanyang libreng oras, naglalaro siya kasama ang pag-coding at paglipat sa chessboard kapag siya ay naiinip, ngunit gusto din niya ang paglayo mula sa nakagawiang gawain sa isang sandali. Ang kanyang hilig sa pagpapakita sa mga tao ng paraan sa paligid ng modernong tech ay nag-uudyok sa kanya na magsulat pa.

Higit pa Mula sa Idowu Omisola

Mag-subscribe sa aming newsletter

Sumali sa aming newsletter para sa mga tip sa tech, pagsusuri, libreng ebook, at eksklusibong deal!

Mag-click dito upang mag-subscribe