429 Too Many Requests
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ă
Runner: 30 iterații, Delay 0Runner: Delay 6000 ms (10 cereri pe minut)Pauza ține ritmul sub limită.
2Test care nu tratează 429
pm.test("200", () => pm.response.to.have.status(200));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ă 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.
Reparația
if (pm.response.code === 429) {
pm.test("429 are Retry-After", function () {
pm.response.to.have.header("Retry-After");
pm.expect(Number(pm.response.headers.get("Retry-After"))).to.be.above(0);
});
} else {
pm.test("Căutare reușită", () => pm.response.to.have.status(200));
}De ce merge
429 nu e o eroare a testului, ci comportamentul corect al API-ului după depășirea limitei. Testul verifică acum ce trebuie să conțină un 429 bun: antetul Retry-After cu un număr pozitiv de secunde. Limita de rate protejează serverul; antetul Retry-After spune cât trebuie să aștepți. După pauză, fereastra de timp se golește, iar cererea e acceptată din nou.
Alte forme ale mesajului
429 Too Many Requests: Ai trimis prea multe cereri.HTTP 429Rate 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
429 Too Many Requests în Collection Runner fără delay Runner-ul trimite cererile una după alta, fără pauză, și depășește limita de rate a API-ului (aici 10 căutări pe minut). Pune un delay între cereri (câmpul Delay din Runner, --delay-request în Newman) calculat după limită și antetul Retry-After. AssertionError: expected response to have header with key 'X-Total-Items' Răspunsul nu are antetul pe care îl cere testul. Verifică în tabul Headers numele exact (aici API-ul folosește X-Total-Count) și dacă endpoint-ul chiar trimite acel antet (listele da, un singur produs nu). Error: read ECONNRESET Conexiunea a fost închisă brusc de cealaltă parte (server, proxy, firewall sau antivirus) în timp ce Postman citea răspunsul. Reîncearcă, verifică proxy-ul și VPN-ul, iar dacă apare la rafale de cereri, adaugă o pauză între ele. Î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.
