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

429 Too Many Requests

Pe scurt

Ai depășit limita de cereri a API-ului (rate limiting). Așteaptă numărul de secunde din antetul Retry-After, pune o pauză între cereri în Runner și Newman și scrie teste care tratează 429 separat de erorile reale.

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

Ce înseamnă

429 Too Many Requests e răspunsul unui API care limitează numărul de cereri pe interval (de exemplu 10 căutări pe minut). Antetele te ajută:

  • Retry-After: după câte secunde poți încerca din nou;
  • X-RateLimit-Limit: limita;
  • X-RateLimit-Remaining: câte cereri mai ai în fereastra curentă.

În Postman apare tipic în Collection Runner sau Newman, când zeci de cereri pleacă fără pauză, sau când repeți de multe ori o cerere manual. Și login-urile greșite repetate duc la 429 (protecție împotriva ghicirii parolei).

Pentru tester, limitarea e o funcționalitate de verificat: după N cereri trebuie să apară 429, cu Retry-After corect, iar după interval accesul revine. Un API public fără nicio limită e, de obicei, un bug de securitate.

De ce apare: cauzele frecvente

1Runner fără pauză

Greșit
JavaScript
Runner: 30 iterații, Delay 0
Corect
JavaScript
Runner: Delay 6000 ms (10 cereri pe minut)

Pauza ține ritmul sub limită.

2Test care nu tratează 429

Greșit
JavaScript
pm.test("200", () => pm.response.to.have.status(200));
Corect
JavaScript
if (pm.response.code === 429) {
  pm.test("429 are Retry-After", () => pm.response.to.have.header("Retry-After"));
} else {
  pm.test("200", () => pm.response.to.have.status(200));
}

Testul descrie comportamentul corect în ambele situații.

Repară tu

Repară eroarea, direct în pagină

Căutarea GET {{baseUrl}}/search?q=mouse permite 10 cereri pe minut; după 11 trimiteri a apărut 429, iar testul existent („Căutare reușită”, doar pe 200) pică. Înlocuiește scriptul cu unul care, la 429, verifică antetul Retry-After, iar altfel statusul 200. Salvează și trimite din nou: testul trebuie să treacă pe răspunsul 429.

Indiciu

Alege testul după pm.response.code.

Alte forme ale mesajului

  • 429 Too Many Requests: Ai trimis prea multe cereri.
  • HTTP 429
  • Rate limit exceeded

Cum o eviți pe viitor

  • Citește limitele în documentație și calibrează Delay-ul.
  • Nu rula teste de volum pe un mediu partajat fără acord.
  • Testează explicit limitarea: statusul 429 și antetele lui.
  • Respectă Retry-After în scripturi și Runner, în loc să repeți imediat cererea.

Întrebări frecvente

Cât trebuie să aștept?

Cât spune Retry-After, în secunde (sau până la data indicată, dacă e o dată).

De ce primesc 429 la login?

După mai multe parole greșite, API-ul blochează temporar încercările pentru acel cont.

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.