...
Eroare Postman · Coduri de status 4xx și 5xx: ce înseamnă și cum le repari

409 Conflict

Pe scurt

Cererea intră în conflict cu starea curentă a resursei: emailul e deja folosit, stocul nu ajunge, comanda nu mai poate fi anulată sau o cheie de idempotență a fost refolosită. Citește codul din body și schimbă datele (de exemplu un email unic cu {{$randomEmail}}).

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

Ce înseamnă

409 Conflict înseamnă că cererea e corectă ca format, dar nu poate fi aplicată din cauza stării serverului. Exemple din API-ul demo:

  • email_exists: înregistrare cu un email deja folosit;
  • out_of_stock: cantitate mai mare decât stocul;
  • order_not_cancellable: anularea unei comenzi livrate;
  • idempotency_key_reused: aceeași cheie de idempotență cu alt body.

În testare, 409 apare des la a doua rulare a aceleiași colecții: prima rulare a creat utilizatorul, a doua încearcă să-l creeze din nou. Soluția e să generezi date unice ({{$randomEmail}}, {{$guid}}) sau să faci curățenie la final.

Ca test negativ, 409 e chiar rezultatul dorit: verifici că serverul refuză duplicatele și conflictele de stare.

De ce apare: cauzele frecvente

1Email fix, deja înregistrat

Greșit
JavaScript
{"email": "ana@magazin.test", ...}
Corect
JavaScript
{"email": "{{$randomEmail}}", ...}

Un email generat la fiecare rulare nu există încă.

2Stoc insuficient

Greșit
JavaScript
POST /cart/items {"productId": 12, "quantity": 5}   # stoc 3
Corect
JavaScript
POST /cart/items {"productId": 12, "quantity": 2}

Cantitatea trebuie să fie disponibilă.

3Acțiune nepermisă în starea curentă

Greșit
JavaScript
POST /orders/1001/cancel   # comandă livrată
Corect
JavaScript
POST /orders/1003/cancel   # comandă în așteptare

Doar comenzile neexpediate se pot anula.

Repară tu

Repară eroarea, direct în pagină

Cererea „Înregistrare” folosește emailul fix ana@magazin.test, care are deja cont, deci serverul răspunde 409 email_exists. Fă cererea repetabilă: folosește un email generat la fiecare trimitere, salvează cererea și trimite-o: trebuie să primești 201.

Indiciu

Postman are o variabilă dinamică pentru emailuri aleatoare.

Alte forme ale mesajului

  • 409 Conflict: Există deja un cont cu acest email.
  • {"error": "email_exists"}
  • HTTP 409

Cum o eviți pe viitor

  • Generează date unice pentru tot ce se creează în teste.
  • Șterge la final ce ai creat, ca rularea următoare să pornească curat.
  • Testează intenționat conflictele importante (duplicat, stoc, stare).
  • În testele care creează resurse, folosește date unice ({{$randomEmail}}, sufixe cu timp).

Întrebări frecvente

Ce diferență e între 409 și 422?

422: datele nu sunt valide în sine. 409: datele sunt valide, dar intră în conflict cu ce există deja.

De ce prima rulare trece și a doua nu?

Prima rulare a creat resursa; a doua încearcă s-o creeze din nou cu aceleași date.

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.