Cum funcționează API-ul? Cum se integrează API-ul în aplicație

Interfața de programare a aplicațiilor (API) este una dintre necesitățile finale pentru construirea de aplicații inteligente. Este un canal de comunicare între două aplicații. Indiferent dacă conștient sau nu, ați folosit API-uri la un moment dat în timp ce navigați pe internet sau folosiți programe în viața de zi cu zi.

API-urile trimit adesea date complexe ca răspunsuri, așa că cum puteți înțelege și utiliza aceste informații pentru a vă servi utilizatorii? API-urile ușurează viața atât dezvoltatorilor experimentați, cât și celor care încep. Deci trebuie să știți cum să le utilizați cu aplicația dvs.

Cu câteva cazuri de utilizare și exemple, să vedem cum puteți utiliza API-urile pentru a vă servi programele ca dezvoltator.

Ce este API-ul?

API-urile oferă o modalitate prin care programele separate să interacționeze între ele

API-urile oferă o modalitate prin care programele separate să interacționeze între ele. API-urile definesc cererile care pot fi făcute, cum sunt făcute solicitările și permit schimbul de date între diferite aplicații software.

API-urile vin în 3 tipuri: publice, private și partenere. API-urile publice (sau API-urile deschise) sunt accesibile public pentru orice dezvoltator. Utilizarea API-urilor publice are anumite limitări și pot fi gratuite sau comerciale. API-urile private sunt utilizate exclusiv în cadrul unei companii sau organizații. API-urile pentru parteneri sunt disponibile numai pentru anumiți parteneri de afaceri, cel mai frecvent utilizate pentru a facilita integrarea software-ului între două afaceri diferite.

Cum funcționează API-ul?

Dezvoltatorii creează API-uri ca produse care pot servi altor dezvoltatori. Scopul este de a face procesele complexe de dezvoltare web mai ușoare, mai eficiente și mai rapide pentru dezvoltatorii de consumatori sau companiile.

Majoritatea companiilor depind acum de API-uri terțe pentru a rezolva problemele și a-și servi mai bine clienții. Cu toate acestea, utilizarea API-ului nu este atât de complicată pe cât cred mulți oameni. Vă puteți gândi la ea ca la o soluție terță parte, care vă oferă un răspuns specific sub formă de date, atunci când faceți o anumită solicitare HTTP.

Utilizarea API-ului este ca și cum ai comanda la o pizzerie. Nu poți merge în bucătărie să le spui ce vrei. Ai nevoie de un chelner care să-ți ia comanda și să o livreze la bucătărie, apoi să te întorci cu pizza pe care o dorești.

Te poți gândi la un API ca fiind legătura dintre tine și bucătărie. În acest caz, sunteți un client care vizitează un restaurant care oferă ospătari (API). Chelnerul va răspunde apoi cu selecția dvs. de pizza (date). Într-un API real, aplicația web este clientul care solicită să consume conținutul furnizorului prin intermediul API-ului, făcând cereri HTTP endpoint.

Cum se utilizează API-ul?

API-urile sunt folosite în multe cazuri

API-urile sunt utilizate în multe scenarii, inclusiv în categorii precum API-urile de bază de date, API-urile de la distanță și API-urile web. Cel mai probabil, interacționați cu API-urile web de mai multe ori pe zi în timp ce navigați pe smartphone sau pe computer. API-urile web fac schimb de cereri și date folosind protocolul HTTP.

Site-urile de rezervare de călătorii, cum ar fi Skyscanner și Booking.com, folosesc API-uri web pentru a cumula datele despre zboruri și destinații pentru clienți. Comoditatea API-urilor web face posibilă confirmarea disponibilității camerelor de hotel și a duratei șederii dumneavoastră în timp real, prin schimbul instantaneu de solicitări și date de la hotel.

Ce este punctul final API?

Conectarea la un API necesită conectarea programului la un punct final API. Vă puteți gândi la aceasta ca la o conexiune bidirecțională. Punctul final conectat la programul dvs. trimite cererea, în timp ce punctul final conectat la API vă trimite înapoi un anumit răspuns.

Un punct final este o adresă URL de solicitare și oferă clientului acces direct la resursele unui API.

Pe lângă preluarea datelor folosind API-ul, puteți, de asemenea, să POST cererile de la furnizor către client, să utilizați metoda PUT pentru a obține mai multe informații de la furnizor, precum și să utilizați metoda DELETE pentru a șterge datele existente din program. Fiecare dintre aceste metode este de obicei disponibilă în documentația API-ului.

Criterii de conectare la API

Integrarea unui API cu programul dvs. nu este doar o decizie spontană - este premeditată. Trebuie să cunoașteți informațiile și cantitatea dorită. Acest lucru ajută la reducerea complexității, mai ales dacă procesați date JSON ca o matrice multidimensională. De asemenea, vă permite să obțineți informațiile specifice de care aveți nevoie pentru programul dvs.

Există sute de API-uri cu reguli diferite pentru conectarea la ele. În timp ce unele API-uri sunt gratuite și open source, altele sunt accesibile doar pe bază de abonament.

În timp ce unele API-uri sunt simple și fără întreruperi, nu necesită nicio cerință prealabilă, alte API-uri vă pot solicita să îndepliniți condiții precum generarea unei chei API sau înregistrarea unui cont de dezvoltator înainte de a vă putea conecta la punctul final.

Cu toate acestea, unul dintre cele mai importante aspecte ale oricărui API este documentația acestuia. Cel mai bine este să citiți și să urmați documentația oricărui API la care intenționați să vă conectați pentru instrucțiuni despre cum să codificați și să utilizați resursele acestuia. Asta pentru că fiecare API are propriile metode și instrucțiuni de conectare.

Pentru a vă conecta la orice API, trebuie să cunoașteți și limbajele de programare pe care le acceptă.

Cum să vă conectați la un API: Exemplu practic

Nu există o modalitate specifică de a vă conecta la API, dar câteva exemple vă vor arăta elementele de bază despre cum puteți utiliza datele API cu aplicația dvs.

Să ne uităm la un scurt exemplu de cod despre cum vă puteți conecta la un API.

Cum să utilizați API-ul Iro.Js Color Picker

Iro.js este un API simplu care vă permite să adăugați un selector de culori gratuit pe site-ul dvs. web. Când selectați un punct de pe roata de culori, API-ul returnează codul hexazecimal sau RGB al acelei culori. Pentru a vă conecta la iro.js API, tot ce trebuie să faceți este să lipiți punctul final CDN (Content Delivery Network) al acestuia la începutul DOM.

Documentația completă a acestui API este disponibilă la iro.js.org:

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

Să vedem cum vă puteți conecta la acest API cu exemplul de cod de mai jos:

Display color picker

În cazul exemplului de API de mai sus, nu aveți nevoie de o cheie API pentru a vă conecta la acesta. Cu toate acestea, pentru a înțelege mai bine, să aruncăm o privire mai atentă la JavaScript. Pentru a vă conecta la acest API, apelați pur și simplu funcția ColorPicker din clasa iro , apoi transmiteți id -ul containerului roții de culori către clasă.

Punctul final al API iro.js este ușor de conectat, deoarece dezvoltatorii săi au făcut munca suplimentară de a codifica stratul pentru utilizatori. Imaginea de mai jos este rezultatul exemplului de cod de mai sus.

Rezultatul codului exemplu

Pentru a vedea cum se întâmplă evenimentul de schimbare a culorii, puteți deschide un alt fișier HTML și puteți lipi următorul cod în secțiunea sa de scripturi :

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);

Codul de mai sus înregistrează valori hexazecimale de culoare de fiecare dată când schimbați poziția selectorului de culori pe roată.

Cum să utilizați API-ul de schimb valutar NoCodeAPI

NoCodeAPI oferă multe API-uri, inclusiv API-ul de conversie valutară. Pentru a vă conecta la acest punct final de schimb valutar, vizitați NoCodeAPI și creați un cont:

https://app.nocodeapi.com/login

Când vă conectați, există o bară de căutare în partea de sus a paginii. În acea bară de căutare, tastați schimb valutar , când apare interogarea dvs., faceți clic pe Activare.

Pe pagina următoare, faceți clic pe Creare API de schimb valutar . Apoi, introduceți un nume pentru API și faceți clic pe Creare.

După ce ați creat API-ul, faceți clic pe Vizualizare documentație. Apoi, selectați limba preferată pentru a vedea codul care se conectează la punctul final API. Apoi puteți copia acel exemplu de cod și îl puteți lipi în aplicația dvs. pentru personalizare suplimentară.

Consultați exemplul de cod de mai jos pentru conversia valutară: