Coduri de stare HTTP

Aici sunt enumerate codurile de stare HTTP care indică faptul că, la efectuarea request-ului către API-ul QR MIA, a survenit o eroare, împreună cu posibilele soluții.

În cazul în care în timpul integrării sau testării întâlniți erori sau neclarități, vă rugăm să consultați documentația API și, dacă este necesar, să contactați echipa de suport tehnic. Pentru o analiză eficientă, vă rugăm să furnizați următoarele detalii:

• HTTP status code

• errorCode

• errorMessage

• Data și ora exactă a request-ului

• Informații despre soluția tehnică utilizată (Project ID, denumirea comerciantului, denumirea aplicației/website-ului, URL website)

Tabel coduri de stare HTTP

Status code	Eroare	Descriere	Soluție
400	Bad Request	Request-ul nu este înțeles de către sistem din cauza unei sintaxe incorecte.	Verificați ca toți parametrii request-ului să fie corecți și să nu lipsească niciunul dintre cei obligatorii.
401	Unauthorized	Token-ul de acces lipsește sau este invalid/expirat.	Verificați dacă a fost generat un token valid și că acesta este transmis corect în antetul Authorization.
403	Forbidden	Accesul este restricționat pentru IP-ul sau datele de autentificare folosite.	Asigurați-vă că Project-ul este activ, corect configurat și că IP-ul este în lista de permisiuni.
404	Not Found	Resursa solicitată nu a fost găsită.	Verificați URL-ul endpoint-ului și parametrul de identificare a resursei (de ex. qrId) pentru corectitudine.
405	Method Not Allowed	Metoda HTTP utilizată (GET, POST, etc.) nu este permisă pe acest endpoint.	Asigurați-vă că utilizați metoda HTTP corectă, conform specificațiilor pentru acel endpoint.
409	Conflict	A apărut un conflict de date (de ex., deja există un QR cu aceiași parametri).	Verificați logica aplicației pentru a evita trimiterea repetată sau contradictorie a acelorași date.
415	Unsupported Media Type	Conținutul request-ului nu este într-un format acceptat de API.	Verificați ca antetul Content-Type să fie setat pe application/json și că body-ul este formatat corect.
422	Unprocessable Entity	Datele trimise sunt valide ca format, dar nu pot fi procesate din cauza conținutului logic eronat.	Verificați valorile transmise (de ex. suma, valuta, parametri personalizați) pentru a respecta regulile de validare.
429	Too Many Requests	Prea multe request-uri într-o perioadă scurtă de timp.	Implementați un mecanism de retry cu backoff și, dacă este necesar, contactați echipa de suport pentru configurarea unor politici personalizate.
500	Internal Server Error	A apărut o eroare internă neașteptată în sistem.	Încercați din nou după câteva momente. Dacă problema persistă, contactați echipa de suport cu detalii despre request.
503	Service Unavailable	API-ul nu este disponibil temporar din cauza supraîncărcării sau mentenanței.	Încercați din nou peste câteva minute. Dacă indisponibilitatea persistă, verificați notificările oficiale sau contactați suportul tehnic.