...
Eroare Postman · JSON și body: erori de parsare

JSONError: Unexpected token '<' at 1:1

Pe scurt

pm.response.json() a încercat să parseze ca JSON un răspuns care începe cu „<”, adică o pagină HTML (o eroare 404/500 a serverului, o pagină de login, un proxy). Uită-te la body în Raw sau Preview și la Content-Type, apoi repară cererea sau verifică statusul înainte să parsezi.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine din parserul JSON al lui Postman: la linia 1, coloana 1, a găsit caracterul < în loc de { sau [. Sub mesaj, Postman afișează începutul body-ului, de obicei <!DOCTYPE html> sau <html>.

Deci serverul a răspuns cu HTML, nu cu JSON. Motive frecvente:

  • URL greșit: ai nimerit pe site-ul web, nu pe API (/products în loc de /api/products);
  • o pagină de eroare a serverului web (404, 500, 502 de la nginx);
  • o pagină de login sau de consimțământ, după o redirecționare;
  • un API care întoarce erorile ca HTML (bug de raportat).

Regula sănătoasă: în teste, verifici întâi statusul și Content-Type, apoi parsezi. Așa, un răspuns HTML produce un test picat clar („expected text/html to include application/json”), nu o eroare de script care oprește toate testele.

De ce apare: cauzele frecvente

1URL spre site în loc de API

Greșit
JavaScript
GET https://magazin.test/products
pm.response.json()
Corect
JavaScript
GET https://api.magazin.test/products
pm.response.json()

Site-ul întoarce pagini HTML; API-ul întoarce JSON.

2Parsare fără verificarea tipului

Greșit
JavaScript
const j = pm.response.json();
Corect
JavaScript
pm.test("Răspuns JSON", () => pm.expect(pm.response.headers.get("Content-Type")).to.include("application/json"));
if (pm.response.headers.get("Content-Type").includes("json")) {
  const j = pm.response.json();
}

Un test pe Content-Type explică problema fără eroare de script.

3Eroare HTML de la server

Greșit
JavaScript
GET /products/999 → 404 <html>...
Corect
JavaScript
# raportează: erorile API-ului trebuie să fie JSON

Clienții API se așteaptă la același format și la erori.

Repară tu

Repară eroarea, direct în pagină

Cererea „Pagină demo” cere https://echo.test/html, care întoarce o pagină HTML, iar scriptul face pm.response.json() și dă JSONError: Unexpected token '<' at 1:1. Înlocuiește scriptul cu un test care verifică faptul că răspunsul e HTML (Content-Type include text/html) și conține tagul <h1>. Salvează și trimite.

Indiciu

Pentru HTML folosește pm.response.text(), nu json().

Alte forme ale mesajului

  • JSONError: Unexpected token 'O' at 1:1
  • JSONError: Unexpected token '<' at 1:1 <!DOCTYPE html>

Cum o eviți pe viitor

  • Pune un test pe Content-Type înaintea testelor pe body.
  • Uită-te la Raw/Preview când un test dă eroare de parsare.
  • Verifică URL-ul final în Console.
  • Verifică Content-Type înainte de pm.response.json().
  • Loghează primele caractere ale răspunsului când parsarea pică.

Întrebări frecvente

De ce Postman îmi arată pagina frumos în Preview?

Pentru că e HTML: Preview o randează ca un browser.

E la fel cu SyntaxError: Unexpected token '<'?

E aceeași problemă. JSONError apare la pm.response.json(), SyntaxError la JSON.parse(...).

Erori înrudite

← Toate erorile Postman

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Postman de la zero, cu exerciții la fiecare lecție

Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.