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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
API-urile publice și multe interne limitează numărul de cereri pe interval: la depășire răspund 429 Too Many Requests, des cu antetul Retry-After (secunde de așteptat). Manual, nu atingi limita; în Runner, cu zeci de iterații fără pauză, o atingi imediat.
Cum calculezi delay-ul: pentru 10 cereri pe minut, ai nevoie de minimum 6000 ms între cereri (60000 / 10). Pune puțin peste, ca margine.
Unde se setează:
- Runner: câmpul Delay (ms);
- Newman:
--delay-request 6000; - în script, la nevoie: verifică
Retry-Afterși repetă cererea după pauză.
Dacă limita e foarte mică și rulările lungi, cere echipei un environment de test cu limite mai mari, în loc să lungești testele.
De ce apare: cauzele frecvente
1Rulare fără delay
Runner: 12 iterații, Delay 0 msRunner: 12 iterații, Delay 6000 ms10 cereri pe minut înseamnă o cerere la 6 secunde.
2Newman în CI
newman run Cautari.json -d termeni.csvnewman run Cautari.json -d termeni.csv --delay-request 6000Aceeași regulă și în linia de comandă.
Repară eroarea, direct în pagină
Colecția Căutări rulează GET {{baseUrl}}/search?q={{termen}} cu fișierul termeni.csv (12 rânduri). Fără delay, de la a 11-a cerere apare 429, pentru că API-ul permite 10 căutări pe minut. Rulează colecția cu datele și un delay potrivit limitei (minimum 6000 ms): toate cele 12 iterații trebuie să treacă.
Indiciu
60000 ms / 10 cereri = câte ms între cereri?
Reparația
Runner → Căutări → Data: termeni.csv → Delay: 6000 ms → Run.
De ce merge
Cu 6 secunde între cereri, în orice minut pleacă cel mult 10 căutări, deci limita API-ului nu mai e depășită. Rularea durează mai mult, dar rezultatele nu mai depind de limită. În Newman, același efect îl are --delay-request 6000. Testul de status trece la fiecare iterație.
Cum o eviți pe viitor
- Află limita de rate a fiecărui endpoint din documentație.
- Setează delay-ul din calcul, nu din încercări.
- Testează separat comportamentul la 429 (statusul și Retry-After).
- Pune delay-ul și în comanda Newman din CI.
- Calculează delay-ul din limita documentată.
- Lasă o marjă peste minimul calculat.
Întrebări frecvente
Delay-ul se aplică și între iterații?
Da, între toate cererile din rulare.
E bug dacă primesc 429?
Nu, e protecția promisă. E bug dacă limita nu există sau Retry-After lipsește.
Erori înrudite
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. Runner-ul nu se mai oprește: setNextRequest în buclă Scriptul trimite mereu Runner-ul înapoi la aceeași cerere, fără o condiție de oprire. Adaugă condiția (de ex. page < totalPages), oprește explicit cu setNextRequest(null) și resetează variabilele folosite ca contor. 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.
