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

503 Service Unavailable

Pe scurt

Serviciul e temporar indisponibil: în mentenanță, supraîncărcat sau încă pornește după un deploy. Răspunsul poate avea antetul Retry-After. Reîncearcă mai târziu și verifică /health; dacă persistă, anunță echipa.

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

Ce înseamnă

503 e răspunsul „nu pot acum”: serverul există, dar refuză temporar cererile. Situații tipice:

  • mentenanță planificată sau un deploy în curs;
  • serviciul e supraîncărcat și respinge cereri ca să se protejeze;
  • o dependență critică (baza de date) e jos, iar health check-ul raportează serviciul ca indisponibil;
  • containerul încă pornește și nu e „ready”.

Un 503 bine făcut include Retry-After, ca clienții să știe când să revină. Diferența față de 500: 503 e intenționat și temporar, 500 e o eroare neprevăzută.

Pentru suita de teste, merită un pas de verificare la început: dacă /health nu răspunde 200, rularea se oprește cu un mesaj clar, în loc de 200 de teste picate.

De ce apare: cauzele frecvente

1Teste rulate în timpul mentenanței

Greșit
JavaScript
newman run c.json   # în fereastra de deploy
Corect
JavaScript
# rulează după deploy, sau verifică întâi /health

Un serviciu în mentenanță răspunde 503 la orice.

2Serviciu supraîncărcat de propriile teste

Greșit
JavaScript
Runner: 500 iterații, Delay 0
Corect
JavaScript
Runner: Delay 200 ms

Rafalele mari pot declanșa protecția la supraîncărcare.

Repară tu

Repară eroarea, direct în pagină

Înainte de suita completă, vrei o verificare de disponibilitate care oprește totul dacă serviciul e în mentenanță (503). Pe cererea „Health”, scrie un test că statusul e 200 și altul că body-ul are status: "ok". Salvează cererea și trimite-o: ambele teste trebuie să treacă.

Indiciu

Folosește pm.response.json().status.

Alte forme ale mesajului

  • 503 Service Unavailable: Service temporarily unavailable
  • HTTP 503

Cum o eviți pe viitor

  • Începe suita cu o cerere /health cu test pe 200 și oprește rularea dacă pică.
  • Respectă Retry-After.
  • Corelează rulările din CI cu ferestrele de deploy.
  • Verifică pagina de status sau canalul echipei pentru mentenanță planificată.
  • În Runner și CI, tratează 503 separat de bug-urile funcționale, ca să nu raportezi greșit.

Întrebări frecvente

Trebuie raportat ca bug?

Nu, dacă e mentenanță anunțată. Da, dacă apare neanunțat sau la încărcări mici.

Ce diferență e între 503 și 429?

429 privește clientul tău (prea multe cereri de la tine). 503 privește serverul (indisponibil pentru toți).

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.