Coduri de eroare

Erorile API folosesc două formate JSON diferite, în funcție de sursa erorii.

Erori standard

Erorile de autentificare, autorizare și limitare a cererilor (401, 403, 429, 503) folosesc un obiect simplu cu un câmp error:

{
  "error": "Descriere lizibilă a erorii."
}

Răspunsurile 404 și 422 nu folosesc acest format — vezi mai jos.

Coduri de stare HTTP

Cod	Denumire	Când apare
200	OK	Cerere procesată cu succes.
201	Created	Încărcare reușită; a fost creat un nou fișier.
401	Unauthorized	Cheia API lipsește sau este invalidă. Verificați header-ul X-Api-Key.
403	Forbidden	Cont suspendat, acces API revocat sau IP-ul solicitantului nu se află pe lista permisă.
404	Not Found	Slug-ul solicitat nu există sau aparține unui alt cont. Corpul răspunsului este {"message": "..."} (format Laravel implicit), nu formatul error de mai sus — și poate include numele intern al modelului.
422	Unprocessable Entity	Validare eșuată - câmpul file lipsește, tipul nu este acceptat sau dimensiunea depășește 200 MB. Corpul răspunsului conține message și obiectul errors.
429	Too Many Requests	Limita de cereri depășită. Respectați header-ul Retry-After.
500	Internal Server Error	Eroare neașteptată pe server. Dacă persistă, contactați echipa de suport.
503	Service Unavailable	API-ul a fost dezactivat temporar. Reîncercați după intervalul Retry-After.

Erori de validare (422)

Când validarea intrărilor eșuează, răspunsul include o hartă errors indexată după numele câmpului. Mesajele sunt întotdeauna în limba engleză, indiferent de limba interfeței — API-ul este exclusiv în engleză:

{
  "message": "The file field is required.",
  "errors": {
    "file": [
      "The file field is required."
    ]
  }
}