Kā darbojas API? Kā lietojumprogrammā integrēt API

Lietojumprogrammu saskarne (API) ir viena no pēdējām vajadzībām viedo lietojumprogrammu izveidei. Tas ir saziņas kanāls starp divām lietojumprogrammām. Neatkarīgi no tā, vai apzināti vai nē, jūs kādreiz esat izmantojis API, pārlūkojot internetu vai izmantojot programmas savā ikdienas dzīvē.

API bieži sūta sarežģītus datus kā atbildes, tāpēc kā jūs varat saprast un izmantot šo informāciju, lai apkalpotu savus lietotājus? API atvieglo dzīvi gan pieredzējušiem izstrādātājiem, gan tiem, kuri tikai sāk darbu. Tāpēc jums ir jāzina, kā tos izmantot savā lietojumprogrammā.

Izmantojot dažus lietošanas gadījumus un piemērus, apskatīsim, kā varat izmantot API, lai izstrādātu savas programmas.

Kas ir API?

API nodrošina veidu, kā atsevišķas programmas var mijiedarboties viena ar otru

API nodrošina veidu, kā atsevišķas programmas var mijiedarboties viena ar otru. API nosaka pieprasījumus, ko var veikt, kā tie tiek veikti, un nodrošina datu apmaiņu starp dažādām programmatūras lietojumprogrammām.

API ir 3 veidu: publiska, privāta un partneru. Publiskās API (vai atvērtās API) ir publiski pieejamas jebkuram izstrādātājam. Publisko API izmantošanai ir daži ierobežojumi, un tie var būt bezmaksas vai komerciāli. Privātās API tiek izmantotas tikai uzņēmumā vai organizācijā. Partneru API ir pieejamas tikai konkrētiem biznesa partneriem, un tās visbiežāk tiek izmantotas, lai atvieglotu programmatūras integrāciju starp diviem dažādiem uzņēmumiem.

Kā darbojas API?

Izstrādātāji veido API kā produktus, kas var kalpot citiem izstrādātājiem. Mērķis ir padarīt sarežģītus tīmekļa izstrādes procesus vieglākus, efektīvākus un ātrākus patērētāju izstrādātājiem vai uzņēmumiem.

Lielākā daļa uzņēmumu tagad ir atkarīgi no trešo pušu API, lai atrisinātu problēmas un labāk apkalpotu savus klientus. Tomēr API izmantošana nav tik sarežģīta, kā daudzi cilvēki domā. Varat to uzskatīt par trešās puses risinājumu, kas sniedz konkrētu atbildi datu veidā, kad veicat konkrētu HTTP pieprasījumu.

API izmantošana ir kā pasūtīšana picu restorānā. Jūs nevarat ieiet virtuvē, lai pateiktu viņiem, ko vēlaties. Jums ir nepieciešams viesmīlis, lai pieņemtu pasūtījumu un nogādātu to virtuvē, pēc tam atgrieztos ar vēlamo picu.

Varat domāt par API kā saikni starp jums un virtuvi. Šajā gadījumā jūs esat klients, kas apmeklē restorānu, kas nodrošina viesmīļus (API). Pēc tam viesmīlis atbildēs ar jūsu picas izvēli (datiem). Reālā API tīmekļa lietojumprogramma ir klients, kas pieprasa patērēt pakalpojumu sniedzēja saturu, izmantojot API, veicot HTTP galapunkta pieprasījumus.

Kā tiek izmantota API?

API tiek izmantotas daudzos gadījumos

API tiek izmantotas daudzos scenārijos, tostarp kategorijās, piemēram, datu bāzes API, attālās API un tīmekļa API. Jūs, visticamāk, mijiedarbojaties ar tīmekļa API vairākas reizes dienā, pārlūkojot viedtālruni vai datoru. Tīmekļa API apmainās ar pieprasījumiem un datiem, izmantojot HTTP protokolu.

Ceļojumu rezervēšanas vietnes, piemēram, Skyscanner un Booking.com, izmanto tīmekļa API, lai apkopotu klientu lidojumu un galamērķa datus. Tīmekļa API ērtības ļauj reāllaikā apstiprināt viesnīcas numuru pieejamību un uzturēšanās ilgumu, nekavējoties apmainoties ar jūsu pieprasījumiem un datiem no viesnīcas.

Kas ir API galapunkts?

Lai izveidotu savienojumu ar API, programma ir jāpievieno API galapunktam. To var uzskatīt par divvirzienu savienojumu. Ar jūsu programmu savienotais galapunkts nosūta pieprasījumu, savukārt galapunkts, kas savienots ar API, nosūta jums konkrētu atbildi.

Galapunkts ir pieprasījuma URL un nodrošina klientam tiešu piekļuvi API resursiem.

Papildus datu izgūšanai, izmantojot API, varat arī POST pieprasījumus no pakalpojumu sniedzēja klientam, izmantot PUT metodi, lai iegūtu vairāk informācijas no nodrošinātāja, kā arī izmantot DELETE metodi, lai dzēstu esošos datus. have no savas programmas. Katra no šīm metodēm parasti ir pieejama API dokumentācijā.

Kritēriji savienojuma izveidei ar API

API integrēšana programmā nav tikai spontāns lēmums – tas ir iepriekš apzināts. Jums jāzina vēlamā informācija un daudzums. Tas palīdz samazināt sarežģītību, īpaši, ja apstrādājat JSON datus kā daudzdimensiju masīvu. Tas arī ļauj iegūt konkrētu informāciju, kas nepieciešama jūsu programmai.

Ir simtiem API ar dažādiem savienojuma noteikumiem. Lai gan dažas API ir bezmaksas un atvērtā koda, citas ir pieejamas tikai abonējot.

Lai gan dažas API ir nevainojamas un vienkāršas, un tām nav nepieciešami nekādi priekšnosacījumi, citas API var prasīt, lai jūs atbilstu nosacījumiem, piemēram, API atslēgas ģenerēšanai vai izstrādātāja konta reģistrēšanai, pirms varat izveidot savienojumu ar galapunktu.

Tomēr viens no svarīgākajiem jebkuras API aspektiem ir tā dokumentācija. Vislabāk ir izlasīt un ievērot dokumentāciju par jebkuru API, ar kuru plānojat izveidot savienojumu, lai iegūtu norādījumus par to resursu kodēšanu un izmantošanu. Tas ir tāpēc, ka katrai API ir savas savienojuma metodes un instrukcijas.

Lai izveidotu savienojumu ar jebkuru API, jums arī jāzina programmēšanas valodas, kuras tā atbalsta.

Kā izveidot savienojumu ar API: praktisks piemērs

Nav īpaša veida, kā izveidot savienojumu ar API, taču daži piemēri parādīs pamatinformāciju par to, kā savā lietojumprogrammā varat izmantot API datus.

Apskatīsim dažus īsus koda piemērus, kā izveidot savienojumu ar API.

Kā lietot Iro.Js Color Picker API

Iro.js ir vienkārša API, kas ļauj savai vietnei pievienot bezmaksas krāsu atlasītāju. Atlasot punktu krāsu aplī, API atgriež šīs krāsas heksadecimālo vai RGB kodu. Lai izveidotu savienojumu ar iro.js API, viss, kas jums jādara, ir ielīmēt tā CDN (satura piegādes tīkla) galapunktu DOM sākumā.

Pilna šīs API dokumentācija ir pieejama vietnē iro.js.org:

https://iro.js.org/guide.html

Apskatīsim, kā varat izveidot savienojumu ar šo API, izmantojot tālāk norādīto koda paraugu:

Display color picker

Iepriekš minētā API parauga gadījumā nav nepieciešama API atslēga, lai ar to izveidotu savienojumu. Tomēr, lai labāk saprastu, apskatīsim JavaScript sīkāk. Lai izveidotu savienojumu ar šo API, vienkārši izsauciet ColorPicker funkciju no klases iro , pēc tam nosūtiet klasei krāsu apļa konteinera ID .

Iro.js API galapunktam ir viegli izveidot savienojumu, jo tā izstrādātāji ir paveikuši papildu darbu, lai kodētu slāni lietotājiem. Tālāk redzamais attēls ir iepriekš minētā koda piemēra rezultāts.

Piemēra koda rezultāts

Lai redzētu, kā notiek krāsu maiņas notikums, varat atvērt citu HTML failu un tā skriptu sadaļā ielīmēt šādu kodu:

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Iepriekš minētais kods reģistrē heksadecimālās krāsu vērtības katru reizi, kad maināt krāsu atlasītāja pozīciju uz riteņa.

Kā lietot NoCodeAPI valūtas maiņas API

NoCodeAPI nodrošina daudzas API, tostarp valūtas konvertēšanas API. Lai izveidotu savienojumu ar šo valūtas maiņas galapunktu, apmeklējiet NoCodeAPI un izveidojiet kontu:

https://app.nocodeapi.com/login

Kad piesakāties, lapas augšdaļā ir meklēšanas josla. Šajā meklēšanas joslā ierakstiet valūtas maiņa , kad tiek parādīts vaicājums, noklikšķiniet uz Aktivizēt.

Nākamajā lapā noklikšķiniet uz Izveidot valūtas maiņas API . Pēc tam ievadiet API nosaukumu un noklikšķiniet uz Izveidot.

Kad esat izveidojis API, noklikšķiniet uz Skatīt dokumentāciju. Pēc tam atlasiet vēlamo valodu, lai skatītu kodu, kas savieno ar API galapunktu. Pēc tam varat kopēt šo parauga kodu un ielīmēt to savā lietotnē turpmākai pielāgošanai.

Valūtas konvertēšanai skatiet tālāk norādīto koda piemēru: