Ce este un API și de ce îl testăm
Aproape orice aplicație pe care o folosești vorbește în spate cu un server prin API-uri. În această lecție afli ce este un API, de ce testerii îl verifică direct, fără interfață, și trimiți primele tale cereri din Postman către magazinul online demo al cursului.
Programe care vorbesc între ele
Când comanzi o pizza dintr-o aplicație, telefonul tău nu știe ce pizza sunt în meniu și nici nu poate încasa banii singur. Aplicația întreabă un server: „ce produse aveți?”, „adaugă pizza în coș”, „plătește comanda”. Serverul răspunde, iar aplicația îți arată rezultatul frumos pe ecran.
Felul în care aplicația și serverul își pun întrebări și își răspund se numește API (Application Programming Interface, adică interfață de programare). Gândește-te la un ospătar într-un restaurant: tu (aplicația) comanzi de la ospătar (API-ul), ospătarul duce comanda la bucătărie (serverul) și îți aduce farfuria (răspunsul). Nu intri în bucătărie și nu trebuie să știi cum se gătește.
- aplicația de livrări cere de la server lista de restaurante din zona ta;
- aplicația băncii cere soldul contului și trimite plățile;
- aplicația de vreme cere temperatura pentru orașul tău.
Un API primește o cerere (request) și trimite înapoi un răspuns (response). Tot cursul ăsta e despre cum trimiți cereri și cum verifici dacă răspunsurile sunt corecte.
De ce testăm API-ul și nu doar ecranul
Un tester poate verifica o aplicație dând clic prin ecrane. Dar bug-urile importante stau des în spatele ecranului: un preț calculat greșit, o comandă care se salvează de două ori, datele altui client care se văd fără voie. Testarea API-ului le găsește direct, la sursă.
| Testare prin interfață | Testare API |
|---|---|
| dai clic prin ecrane | trimiți cereri direct la server |
| lentă, se strică la orice schimbare de design | rapidă și stabilă |
| vezi doar ce arată ecranul | vezi exact datele trimise și primite |
| bug-ul apare târziu | bug-ul apare devreme, înainte să existe ecranul |
De aceea, în echipele moderne, testele de API sunt cele mai multe după testele unitare scrise de programatori. Un tester care știe Postman este căutat la interviuri.
Nu ai nevoie de alt curs ca să începi. Dacă vrei să devii tester, cursul de testare manuală te învață să gândești cazurile de test (clase de echivalență, valori limită, rapoarte de bug). Aici aplici aceleași idei pe API-uri, iar cele două cursuri se completează.
Ce este Postman
Postman este cea mai folosită aplicație pentru lucrul cu API-uri. Cu el scrii o cerere, o trimiți, vezi răspunsul, scrii teste automate care verifică răspunsul și le rulezi pe toate odată. Îl folosesc testeri, programatori și chiar oameni de produs.
În dreapta ai un Postman care rulează direct în browser. Arată și se comportă ca aplicația reală, dar vorbește cu un magazin online demo pregătit pentru curs, la adresa https://api.magazin.test. Nu poți strica nimic: dacă vrei să o iei de la capăt, apeși „Resetează”.
Ce vezi în dreapta
- bara din stânga: Collections (cererile salvate), Environments (variabile), History (cererile trimise);
- tabul de cerere: metoda (GET), câmpul URL și butonul portocaliu Send;
- sub URL: Params, Authorization, Headers, Body, Scripts, Settings (le iei pe rând în curs);
- jos: panoul de răspuns, cu codul de status, timpul, mărimea și body-ul.
Prima ta cerere
Orice API serios are un endpoint care spune doar „sunt pornit”. La magazinul nostru este /health. O cerere GET înseamnă „dă-mi informația”: nu trimiți nimic, doar ceri.
GET https://api.magazin.test/health
200 OK
{
"status": "ok",
"time": "2026-11-03T09:00:00.000Z"
}200 OK este codul de status: totul a mers bine. Body-ul este în format JSON, un format de text cu acolade, chei și valori, pe care îl înveți în detaliu în lecția 7. Aici îți spune că serverul e pornit ("status": "ok") și ora lui.
Lista de produse
Acum cere ceva mai interesant: produsele din magazin. Endpoint-ul este /products. Răspunsul e mai lung, iar în panou îl poți derula.
GET https://api.magazin.test/products
În răspuns vei vedea:
- data: o listă cu primele 10 produse, fiecare cu id, name, price, currency, category, stock;
- page și limit: pagina curentă și câte produse sunt pe pagină;
- total: câte produse are magazinul în total (30).
Nu-ți face griji dacă încă nu înțelegi fiecare cuvânt din răspuns. Până la finalul modulului gratuit vei ști să citești orice cerere și orice răspuns HTTP.
Ce faci în acest curs
Vei porni de la cereri simple și vei ajunge să lucrezi ca un tester de API într-o echipă reală:
- trimiți cereri cu autentificare, variabile și environment-uri;
- scrii teste automate care verifică statusul, datele și timpul de răspuns;
- cauți bug-uri ascunse în magazin și scrii rapoarte clare;
- rulezi toată suita de teste cu date din fișiere și o pregătești pentru CI cu Newman;
- te pregătești de interviu și construiești un proiect pentru portofoliu.
Fiecare lecție se termină cu un exercițiu în Postman-ul din dreapta, verificat automat. Când l-ai rezolvat, verificarea pornește singură.
Fă cunoștință cu magazinul demo: verifică dacă API-ul este pornit, apoi cere lista de produse.
- Trimite o cerere GET către https://api.magazin.test/health.
- Trimite o cerere GET către https://api.magazin.test/products.
- Uită-te în ambele răspunsuri la codul de status și la body.
Soluția exercițiului
1. În câmpul URL scrie https://api.magazin.test/health și apasă Send: primești 200 OK și {"status": "ok", ...}.
2. Schimbă URL-ul în https://api.magazin.test/products și apasă din nou Send: primești 200 OK și lista de produse. 