JSON pe înțelesul tuturor
Aproape toate API-urile moderne vorbesc în JSON. Ai văzut deja răspunsuri JSON în lecțiile trecute; acum înveți să le citești sigur pe tine, să le scrii singur fără greșeli și să trimiți primul tău body JSON într-o cerere POST.
Ce este JSON
JSON (JavaScript Object Notation) este un format de text pentru date. E ușor de citit pentru oameni și ușor de procesat pentru programe, așa că aproape orice API îl folosește. Un JSON simplu arată așa:
{
"nume": "Ana",
"varsta": 25,
"activ": true
}Acoladele { } înseamnă un obiect: o colecție de perechi "cheie": valoare, despărțite prin virgulă. Cheia este mereu un text între ghilimele duble.
Cele șase tipuri de valori
| Tip | Exemplu | Observații |
|---|---|---|
| text (string) | "Ana" | mereu între ghilimele duble |
| număr | 25, 89.5 | fără ghilimele; zecimalele cu punct, nu cu virgulă |
| boolean | true, false | adevărat sau fals, fără ghilimele |
| null | null | „nicio valoare” |
| obiect | {"oras": "Iași"} | perechi cheie-valoare între acolade |
| listă (array) | ["QA", "API"] | valori în ordine, între paranteze drepte |
"25" și 25 nu sunt același lucru: primul este un text, al doilea un număr. Un bug frecvent este un API care trimite prețul ca text ("89") când documentația promite un număr. Testerii verifică și tipul, nu doar valoarea.
Cum citești un JSON imbricat
Obiectele și listele se pot pune unele în altele. Răspunsul de la /products este un obiect care conține o listă (data) de obiecte (produsele). Ca să ajungi la o valoare, scrii „drumul” până la ea:
{
"data": [
{ "id": 1, "name": "Laptop UltraSlim 14", "price": 3499 },
{ "id": 2, "name": "Laptop Gaming X17", "price": 6299 }
],
"total": 30
}| Drumul | Valoarea | Cum îl citești |
|---|---|---|
| total | 30 | cheia total din obiectul principal |
| data[0] | primul produs | listele se numără de la 0 |
| data[0].price | 3499 | prețul primului produs |
| data[1].name | "Laptop Gaming X17" | numele celui de-al doilea produs |
Vei folosi exact aceste drumuri în testele automate din modulul următor, de exemplu ca să verifici că data[0].price este un număr pozitiv.
Trimite un body JSON
Până acum ai trimis doar cereri fără body. Ca să trimiți date, de exemplu un utilizator nou, pui un JSON în body-ul unei cereri POST:
POST https://echo.test/post
{
"nume": "Ana",
"varsta": 25,
"cursuri": [
"QA",
"API"
]
}Serverul de ecou îți întoarce textul primit în data și JSON-ul citit în câmpul json, deci vezi exact cum l-a înțeles serverul:
200 OK
{
"args": {},
"data": "{\n \"nume\": \"Ana\",\n \"varsta\": 25,\n \"cursuri\": [\n \"QA\",\n \"API\"\n ]\n}",
"files": {},
"form": {},
"headers": {
"content-type": "application/json",
"user-agent": "PostmanRuntime/7.43.0",
"accept": "*/*",
"cache-control": "no-cache",
"postman-token": "937b2e84-d09a-42a1-837b-2e84d09a92a1",
"host": "echo.test",
"accept-encoding": "gzip, deflate, br",
"connection": "keep-alive",
"content-length": "75"
},
"json": {
"nume": "Ana",
"varsta": 25,
"cursuri": [
"QA",
"API"
]
},
"method": "POST",
"url": "https://echo.test/post"
}Când alegi raw → JSON, Postman adaugă singur antetul Content-Type: application/json. Așa știe serverul că body-ul este JSON. Îl vezi în răspuns, la headers → content-type.
Greșeli frecvente (și cum le recunoști)
JSON este strict: o singură virgulă în plus și tot textul devine invalid. Postman te avertizează sub editor când JSON-ul nu pare valid. Iată ce primește serverul când trimiți un JSON cu virgulă la final:
{"nume": "Ana", "varsta": 25,}200 OK
{
"args": {},
"data": "{\"nume\": \"Ana\", \"varsta\": 25,}",
"files": {},
"form": {},
"headers": {
"content-type": "application/json",
"user-agent": "PostmanRuntime/7.43.0",
"accept": "*/*",
"cache-control": "no-cache",
"postman-token": "bba83900-c19e-4832-8ba8-3900c19ef832",
"host": "echo.test",
"accept-encoding": "gzip, deflate, br",
"connection": "keep-alive",
"content-length": "30"
},
"json": null,
"method": "POST",
"url": "https://echo.test/post"
}Textul a ajuns (data), dar serverul nu l-a putut citi ca JSON, așa că json este null. Un API real ar răspunde de obicei cu 400 Bad Request.
- virgulă după ultimul element: {"a": 1,} este invalid;
- ghilimele simple: {'nume': 'Ana'} este invalid, JSON acceptă doar ghilimele duble;
- cheie fără ghilimele: {nume: "Ana"} este invalid;
- comentarii: JSON nu are comentarii, nici //, nici /* */;
- zecimale cu virgulă: 89,5 este invalid, scrie 89.5.
JSON în viața reală
Iată cum arată un produs real din magazinul demo. Încearcă să citești singur tipul fiecărui câmp:
GET https://api.magazin.test/products/16
200 OK
{
"id": 16,
"name": "Testarea software pe înțelesul tuturor",
"sku": "TESTAREA-SOF-016",
"price": 79,
"currency": "RON",
"category": "carti",
"stock": 50,
"rating": 4.9,
"active": true,
"createdAt": "2026-02-19T10:00:00.000Z"
}- id, price, stock și rating sunt numere;
- name, sku, currency, category și createdAt sunt texte (data e scrisă ca text, în formatul standard ISO);
- active este boolean.
Trimite serverului de ecou datele unei cursante, în format JSON, și verifică în răspuns că serverul le-a citit corect.
- Pregătește POST https://echo.test/post.
- În Body alege raw → JSON și scrie un obiect cu nume = "Ana", varsta = 25 (număr) și cursuri = lista ["QA", "API"].
- Trimite cererea și verifică în răspuns câmpul json.
Soluția exercițiului
1. Metoda POST, URL https://echo.test/post.
2. Body → raw → JSON:
{
"nume": "Ana",
"varsta": 25,
"cursuri": ["QA", "API"]
}
3. Send: în răspuns, câmpul json conține exact obiectul trimis, iar headers.content-type este application/json. 