Când verifici vremea pe telefon, plătești cu cardul într-un magazin online sau te autentifici într-o aplicație folosind contul altui serviciu, în spate se întâmplă același lucru: două programe vorbesc între ele. Felul în care o fac se numește API, o abreviere pe care o auzi tot mai des, dar care rămâne vagă pentru mulți oameni.
Nu e nevoie să programezi ca să înțelegi ideea. Un API este, pe scurt, un mod organizat prin care o aplicație cere ceva altei aplicații și primește un răspuns, fără să afle cum funcționează aceasta pe dinăuntru. Mai jos explicăm conceptul cu o comparație simplă, apoi cu exemple și cu pașii unui prim test.
Comparația cu restaurantul
Imaginează-ți un restaurant. Tu, clientul, stai la masă și vrei o supă. Nu intri în bucătărie ca să o pregătești și nici nu ai nevoie să știi rețeta. Ai la îndemână meniul, care îți spune ce poți comanda, și un ospătar, care duce comanda în bucătărie și îți aduce farfuria înapoi.
În lumea aplicațiilor, rolurile se împart la fel. Aplicația ta este clientul. Serverul care deține datele sau funcțiile dorite este bucătăria. API-ul este ospătarul împreună cu meniul: stabilește ce poți cere și în ce formă, transmite cererea și aduce răspunsul. Documentația API-ului este meniul, adică lista a tot ce se poate cere.
Exemple din viața de zi cu zi
API-urile sunt peste tot, chiar dacă nu le vezi:
- Prognoza meteo din aplicația ta. Aplicația nu măsoară vremea, ci cere date unui serviciu specializat și le afișează frumos.
- Plata online. Magazinul nu procesează singur cardul, ci trimite datele către un serviciu de plăți, care confirmă sau respinge tranzacția.
- Harta dintr-un site de închirieri sau de livrări. Harta vine de la un serviciu de cartografie, nu e desenată de site.
- Autentificarea cu un cont existent. Aplicația întreabă un alt serviciu dacă ești cine spui că ești.
- Cursul valutar dintr-un program de contabilitate. Valorile se actualizează automat dintr-o sursă oficială.
Avantajul principal este reutilizarea. Fiecare firmă se ocupă de ce știe mai bine, iar alții se pot baza pe munca ei fără să o refacă de la zero.
Cum arată o cerere și un răspuns
O comunicare prin API are, în mare, patru elemente. Cererea merge la o adresă anume, numită punct final. Ea conține o acțiune, de exemplu „vreau să citesc” sau „vreau să trimit”. Uneori include și date suplimentare, cum ar fi orașul pentru care vrei prognoza. Serverul răspunde cu un cod care spune cum a mers și, de obicei, cu informațiile cerute, de multe ori într-un format text structurat, numit JSON, ușor de citit atât de oameni, cât și de programe.
Codurile de răspuns sunt un limbaj comun. Cel mai cunoscut este „404”, care spune că ceva nu a fost găsit. Un cod din categoria „200” înseamnă că totul a mers, iar unul din categoria „500” anunță o eroare pe partea serverului.
Cheile API și regulile de folosire
Majoritatea serviciilor cer o cheie API, un șir de caractere care te identifică. Cu ajutorul ei, furnizorul știe cine face cererile, poate limita numărul lor și poate opri accesul în caz de abuz. Unele API-uri sunt gratuite până la un anumit număr de cereri, altele se plătesc, iar altele sunt deschise tuturor.
Cheia se tratează ca o parolă. Nu o pui în cod public, nu o trimiți pe e-mail și nu o lași la vedere în capturi de ecran. Dacă o cheie ajunge pe mâini greșite, cineva poate face cereri în numele tău, iar tu poți plăti consecințele sau poți pierde accesul.
Cum faci un prim test, pas cu pas
- Alege un API gratuit și simplu, cu documentație clară, de exemplu unul pentru date meteo sau pentru cursuri valutare.
- Citește documentația și identifică punctul final pe care vrei să îl folosești și parametrii pe care îi cere.
- Dacă e nevoie, creează un cont și obține o cheie API, apoi păstrează-o într-un loc sigur.
- Trimite o cerere simplă dintr-un instrument de testare sau chiar din bara browserului, dacă API-ul permite acest lucru.
- Citește răspunsul și caută în el informația dorită, apoi încearcă să schimbi un parametru și vezi ce se modifică.
- Observă ce se întâmplă când greșești adresa sau omiți un parametru, pentru că erorile îți arată cum gândește serviciul.
Dacă un test nu merge din prima, e normal. Rezolvarea problemelor face parte din muncă, iar ghidul despre dezvoltarea abilităților de rezolvare a problemelor în IT te ajută să abordezi cu metodă situațiile în care nu înțelegi de ce primești o eroare.
Unde ajută API-urile în practică
Pe lângă aplicațiile pe care le folosim zilnic, API-urile stau la baza multor automatizări. Un exemplu e transferul automat al comenzilor dintr-un magazin online într-un program de facturare. Un altul e trimiterea unui mesaj de notificare când se întâmplă ceva într-un sistem. Cine lucrează cu astfel de legături economisește ore de muncă manuală și reduce greșelile de copiere. Pentru un tablou mai larg al acestui subiect, citește și despre tehnologiile de automatizare în industria IT.
Întrebări frecvente
Trebuie să știu programare ca să folosesc un API?
Nu neapărat. Există unelte care îți permit să trimiți cereri și să citești răspunsuri fără să scrii cod, iar multe platforme de automatizare au conexiuni gata făcute. Cunoștințele de programare ajută însă când vrei să construiești ceva personalizat.
Care e diferența dintre un API public și unul privat?
Un API public poate fi folosit de oricine respectă regulile furnizorului, adesea după înregistrare. Unul privat este destinat intern unei firme sau unor parteneri și nu e deschis publicului.
Poate un API să se schimbe peste noapte?
Poate, dar furnizorii serioși anunță modificările în avans și mențin versiuni mai vechi o perioadă. De aceea e bine să citești periodic anunțurile din documentație dacă te bazezi pe un serviciu.
Un API nu e nimic mai misterios decât un ospătar bine instruit: știe ce se poate cere, transmite mesajul corect și aduce înapoi răspunsul. Odată ce ai înțeles această idee, multe dintre lucrurile care păreau magie în aplicațiile de zi cu zi încep să aibă o logică limpede, iar un prim test te poate convinge cât de accesibil este subiectul.
Foto: Daniil Komov / Pexels
