Ce este un API? [Citire rapida]

Dacă nu sunteți dezvoltator, dar lucrați în tehnologie, termenul API este probabil ceva pe care îl înțelegeți într-un sens conversațional. Probabil că știți ce înseamnă (interfață de programare a aplicațiilor) și poate echipele dvs. folosesc API-urile pentru a-și face treaba – sau poate este chiar produsul în sine (Twilio SendGrid, de exemplu).

Dar ce este exact un API și cum funcționează?

Înțelegerea principiilor mai profunde din spatele API-urilor vă va ajuta să comercializați, să vindeți sau să utilizați mai bine aceste tehnologii.

Această postare explică cum funcționează API-urile, cum le construiesc dezvoltatorii și cum să le folosească (cu exemple din lumea reală).

Cum funcționează API-urile?

Modul în care browserele web interacționează cu serverele este un principiu fundamental al API-urilor. Web-ul este o colecție de servere la distanță dispersate pe întreaga planetă. Când deschideți un browser și introduceți un site web, browserul efectuează un apel către serverul clientului (indiferent de aplicația sau serverul pe care este găzduit un site web) pentru a prelua și afișa orice se află pe acea adresă URL.

Deși un API nu este serverul în sine, este partea serverului, cunoscută sub numele de punct final, care trimite și primește anumite răspunsuri. API-urile sunt o modalitate prin care diferitele componente de software de a comunica (denumită și trimitere și primire) între ele prin deschiderea punctelor finale.

Dezvoltatorii au configurat apeluri API pentru a prelua date specifice necesare pentru diverse scopuri atunci când creează aplicații sau site-uri web. De exemplu:

• Tocmai ți-ai deschis aplicația Instagram? Acest lucru a fost posibil printr-un apel API.
• Ați adăugat vreodată un eveniment la Google Calendar de pe alt site web sau e-mail? Site-ul respectiv folosea API-ul Google Calendar pentru a prelua acele informații specifice de pe serverul Google Calendar.

Rezultat: dezvoltatorii au configurat apeluri API pentru a prelua anumite tipuri de date pentru a afișa ceea ce au nevoie atunci când un utilizator se află pe un site web sau rulează o aplicație.

Ascensiunea REST

Un alt termen pe care probabil l-ați auzit este REST API. Nu este diferit de definiția tradițională a unui API. Totuși, merită să înțelegeți de ce API-urile REST au devenit atât de populare și ce diferențiază API-urile REST de altele.

La început, API-urile au fost construite pentru a îndeplini cerințele SOAP (Simple Object Access Protocol). Dar această metodă a fost puțin plictisitoare și a necesitat multă lățime de bandă pentru a transfera seturi de date. De asemenea, a cerut multă energie pentru dezvoltatori (ca nu genul distractiv). SOAP folosește limbajul de markup XML notoriu de greu pentru a afișa date. Util pentru a asigura compatibilitatea universală, dar cam atât.

Dezvoltatorii căutau modalități mai ușoare și mai flexibile de a efectua apeluri API. API-urile REST (transfer de stat reprezentativ) oferă o soluție alternativă la API-ul SOAP. Nu sunt constrânși de un protocol specific, deși trebuie să îndeplinească anumite stiluri arhitecturale (dacă sunteți interesat să vă scufundați în asta, mergeți aici).

În loc să fie afișat cu marcaj XML, serverul folosește limbajul ușor JSON (doar fișiere text). API-urile REST sunt mult mai ușoare ca lățime de bandă decât SOAP - de obicei sunt doar o adresă URL - și sunt optimizate în mod natural pentru comunicarea pe web.

O concluzie: Gândiți-vă la API-urile REST ca la Marie Kondo a datelor. Ei iau și folosesc doar *exact* ceea ce au nevoie. API-urile SOAP sunt ca garajul vecinului tău, care este în prezent plin până la refuz cu hârtie igienică.

Înțelegerea diferitelor tipuri de API-uri

Indiferent de protocolul sau stilurile pe care le urmează un API, există mai multe tipuri de API, inclusiv:

• API-uri deschise – Cunoscute și ca API-uri publice, aceste puncte finale sunt accesibile de către orice dezvoltator și, de obicei, nu impun nicio restricție utilizatorului. Acceptă de obicei donații.
• API-uri pentru parteneri – Acestea sunt API-uri care sunt concepute pentru a fi utilizate împreună și, de obicei, pot fi accesate numai de un anumit tip de piață.
• API-uri interne – Acestea sunt instrumente interne pe care companiile le folosesc pentru a-și ajuta angajații să fie mai eficienți sau pentru a oferi angajaților o modalitate mai sigură de a partaja date/informații.
• API-uri compozite – API -urile compozite sunt o modalitate de a consolida apelurile API care sunt legate, dar care în mod normal ar necesita apeluri API individuale.

Exemple reale de API-uri

Există o mulțime de API-uri în sălbăticie (unele numără până la 15.000) care ajută utilizatorii să acceseze diverse aplicații. Mai jos sunt câteva notabile care vă vor ajuta să înțelegeți domeniul de aplicare al ecosistemului API.

Cocktailul DB

Să presupunem că dețineți un magazin local de băuturi alcoolice și doriți să furnizați rețete de cocktail-uri pe site-ul dvs. web. Ați putea lua în considerare utilizarea API-ului Cocktail DB de mai sus. Toate aceste date (rețetele de cocktail) există deja pe serverul altcuiva și pot fi evaluate prin intermediul API-ului.

Când un utilizator face clic pe rețetele de margarita (probabil cocktail-ul superior), serverele lor găsesc că rețeta specifică o trimite în JSON, este preluată de site-ul web și analizată în HTML și CSS pentru a fi prezentabilă în browser-ul dvs. de site.

OpenWeatherMap

Adăugarea unei secțiuni meteo pe site-ul dvs. este un caz de utilizare foarte comun. Gândiți-vă la orice stațiune de schi, magazine de biciclete sau companie de turism. API-ul OpenWeatherMap stochează toate prognozele meteo și informațiile și afișează doar partea pe care o solicitați.

Acest API oferă atât versiuni gratuite, cât și versiuni premium, în funcție de câte date doriți să afișați.

SendGrid Email API

API-ul SendGrid Email folosește SMTP (protocol simplu de transfer de e-mail) pentru a permite clienților să trimită cantități mari de e-mailuri tranzacționale și declanșate – gândiți-vă la resetarea parolei, confirmarea contului și notificările de expediere.

Twilio SMS

Twilio SMS API este un alt API REST care oferă o modalitate de a adăuga funcții de mesagerie la aplicații. Mesageria SMS a devenit din ce în ce mai populară ca modalitate prin care mărcile pot comunica cu clienții, deoarece este personală, în timp real, iar aceste mesaje sunt citite la rate mult mai mari.

Cum se utilizează un API

Înainte ca dvs. sau echipa dvs. să începeți să utilizați API-urile, este important să știți dacă acestea sunt deschise, utilizate împreună cu un serviciu partener sau un compozit.

Cum să începeți cu un API

Citiți documentația. Orice API ar trebui să aibă documentația aplicabilă pe care să o urmați. Vă va spune ce dependențe aveți, ce tip de API este și cum să îl utilizați. Documentația slabă ar trebui să fie un semnal roșu pentru tine și dezvoltatorul tău. Suntem destul de mândri de documentația superbă a lui Twilio și SendGrid.

Generați o cheie API. Va trebui să generați o cheie API pentru a începe să o utilizați. Iată instrucțiunile din API-ul Google Maps:

Notă : Nu partajați niciodată cheile API și asigurați-vă că nu sunt vizibile în niciun cod public pe care îl puneți pe GitHub.

Începeți să construiți: trimiteți e-mail gratuit cu API-ul SendGrid Email

Restul depinde de tine! Oportunitățile sunt cu adevărat nesfârșite atunci când lucrați cu API-uri. Pentru a vedea toate oportunitățile de a lucra cu Twilio API, consultați Twilio Code Exchange.

Dacă sunteți interesat să utilizați API-ul SendGrid Email pentru a trimite e-mailuri gratuite, consultați-l aici.