409 Conflict
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
{"email": "ana@magazin.test", ...}{"email": "{{$randomEmail}}", ...}Un email generat la fiecare rulare nu există încă.
2Stoc insuficient
POST /cart/items {"productId": 12, "quantity": 5} # stoc 3POST /cart/items {"productId": 12, "quantity": 2}Cantitatea trebuie să fie disponibilă.
3Acțiune nepermisă în starea curentă
POST /orders/1001/cancel # comandă livratăPOST /orders/1003/cancel # comandă în așteptareDoar comenzile neexpediate se pot anula.
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.
Reparația
{
"name": "Radu Ene",
"email": "{{$randomEmail}}",
"password": "Parola123!"
}De ce merge
Serverul refuza corect al doilea cont cu același email. Cu un email generat, fiecare trimitere creează un cont nou, deci testul poate fi rulat de oricâte ori. 409 apare când cererea intră în conflict cu starea curentă a datelor, de exemplu o valoare unică deja folosită. Cu date unice, fiecare rulare creează o resursă nouă, iar testul devine repetabil.
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
{{randomEmail}} trimis literal în loc de {{$randomEmail}} Variabilele dinamice ale Postman încep cu $: {{$randomEmail}}, {{$guid}}, {{$timestamp}}. Fără $, {{randomEmail}} e căutată ca variabilă obișnuită, nu se găsește și pleacă literal, iar serverul respinge emailul. Adaugă $ după acolade. 422 Unprocessable Entity Body-ul e JSON valid, dar datele încalcă regulile: un câmp obligatoriu lipsește, un email are format greșit, o valoare e în afara limitelor sau are tipul greșit. Citește lista de erori din răspuns (de obicei pe câmpuri) și corectează exact câmpurile indicate. Iterația 2 pică din cauza unei variabile rămase din iterația 1 Environment-ul nu se golește între iterații: o valoare salvată la iterația 1 (de ex. tokenul) rămâne și la iterația 2. Dacă iterația 2 trebuia să ruleze fără ea, rezultatul e greșit. Șterge (unset) variabilele la începutul fiecărei iterații sau salvează-le doar când e cazul. Î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.
