...
← Curs API Testing cu Postman: toate lecțiile
Lecția 7 · JSON

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

TipExempluObservații
text (string)"Ana"mereu între ghilimele duble
număr25, 89.5fără ghilimele; zecimalele cu punct, nu cu virgulă
booleantrue, falseadevărat sau fals, fără ghilimele
nullnull„nicio valoare”
obiect{"oras": "Iași"}perechi cheie-valoare între acolade
listă (array)["QA", "API"]valori în ordine, între paranteze drepte
Important

"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
}
DrumulValoareaCum îl citești
total30cheia total din obiectul principal
data[0]primul produslistele se numără de la 0
data[0].price3499preț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:

1
Alege metoda POST și scrie URL-ul https://echo.test/post.
2
Deschide tabul Body și alege raw.
3
În lista din dreapta alege JSON (nu Text).
4
Scrie JSON-ul în editor.
5
Apasă Send.
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.
Exercițiul tău

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.
{"nume": "Ana", "varsta": 25, "cursuri": ["QA", "API"]} — cu ghilimele duble și fără virgulă la final.

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.
Excelent! Continuă cu lecția următoare →
PostmanPostman
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu API-uri și Postman Lecția 7 · JSON pe înțelesul tuturor
Progres 0% 0 din 12
Lecția curentă 7 / 10 Json