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

Răspunsul e HTML în loc de JSON (Content-Type: text/html)

Pe scurt

Endpointul unui API JSON a întors o pagină HTML (des la erori 404 sau 500), deci clienții nu pot citi eroarea. Dacă URL-ul e corect, e un bug de contract: scrie un test pe Content-Type și raportează-l cu cererea atașată.

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

Ce înseamnă

Un API JSON trebuie să răspundă cu JSON și la erori: clientul (aplicația mobilă, frontend-ul) citește error și message ca să afișeze ceva util. Când un endpoint întoarce o pagină HTML (<html><h1>404 Not Found</h1>...), clientul primește o eroare de parsare și afișează un mesaj generic.

Cauze:

  • framework-ul web întoarce pagina lui implicită de eroare, pentru că API-ul nu are un handler JSON pentru 404/500;
  • un proxy sau un gateway răspunde înaintea aplicației;
  • antetul Content-Type e setat greșit (text/html), deși body-ul e JSON.

În Postman, problema apare ca JSONError: Unexpected token '<' în teste. Un test pe Content-Type scris înaintea celorlalte o transformă într-un rezultat clar, ușor de raportat.

De ce apare: cauzele frecvente

1Eroare 404 servită ca pagină HTML

Greșit
JavaScript
GET /products/999  → 404 Content-Type: text/html
<html>...</html>
Corect
JavaScript
GET /products/999  → 404 Content-Type: application/json
{"error": "not_found", "message": "Produsul 999 nu există."}

Formatul erorilor face parte din contractul API-ului.

2Test care parsează fără verificare

Greșit
JavaScript
const j = pm.response.json();
Corect
JavaScript
pm.test("Eroarea e JSON", () => pm.expect(pm.response.headers.get("Content-Type")).to.include("application/json"));

Testul pe Content-Type arată problema fără eroare de script.

Repară tu

Repară eroarea, direct în pagină

Pe acest mediu, GET {{baseUrl}}/products/999 răspunde 404 cu o pagină HTML în loc de JSON. Adaugă pe cererea „Produs inexistent” un test „Eroarea e JSON” care verifică Content-Type application/json (va pica, arătând problema), trimite cererea, apoi raportează bug-ul: titlul trebuie să spună că eroarea 404 vine ca HTML, cu ultima cerere atașată.

Indiciu

Titlul raportului trebuie să conțină „HTML” și „404”.

Alte forme ale mesajului

  • Content-Type: text/html; charset=utf-8 (așteptat application/json)

Cum o eviți pe viitor

  • Pune în scriptul colecției un test pe Content-Type pentru toate răspunsurile API-ului.
  • Testează și răspunsurile de eroare (404, 422, 500), nu doar succesul.
  • Raportează orice răspuns HTML de la un API JSON.
  • Adaugă un test pe Content-Type înaintea testelor pe body.

Întrebări frecvente

E un bug sau o alegere?

Pentru un API JSON e bug: clienții nu pot interpreta eroarea. Excepție: endpointuri documentate care servesc HTML.

Cum văd pagina primită?

Tabul Body → Preview randează HTML-ul.

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.