Coduri de eroare
Toate erorile întorc un JSON cu code, message și request_id. Tabelul de mai jos listează codurile și remedierea recomandată.
| Cod | Status HTTP | Mesaj | Remediere |
|---|---|---|---|
auth_required | 401 | Lipsește headerul Authorization. | Trimite Authorization: Bearer YOUR_API_KEY pe fiecare cerere. |
invalid_api_key | 401 | Cheia API este invalidă sau a fost revocată. | Rotește cheia din dashboard și actualizează secretul în mediul tău. |
forbidden | 403 | Cheia nu are dreptul să apeleze acest endpoint. | Verifică scope-urile cheii în dashboard sau folosește o cheie cu scope mai larg. |
rate_limited | 429 | Ai depășit rata de cereri permisă pe minut. | Respectă headerele Retry-After și X-RateLimit-* sau treci pe un plan mai mare. |
quota_exceeded | 402 | Ai consumat quota lunară a planului. | Treci pe un plan mai mare sau așteaptă următoarea perioadă de facturare. |
validation_failed | 422 | Corpul cererii nu trece de validare. | Consultă câmpul details din răspuns pentru câmpurile invalide. |
not_found | 404 | Resursa cerută nu există. | Verifică ID-ul sau codul poștal trimis. |
idempotency_conflict | 409 | Idempotency-Key reutilizat cu un corp diferit. | Folosește o cheie nouă pentru cereri diferite sau retrimite exact același corp. |
service_unavailable | 503 | Serviciul este temporar indisponibil. | Reîncearcă cu exponential backoff. Verifică status.posty.ro pentru incidente. |
internal_server_error | 500 | Eroare neașteptată pe partea noastră. | Trimite request_id la support@posty.ro pentru investigare. |