Dezvoltatori

Erori, coduri și limite

Formatul erorilor, codurile frecvente ale aplicațiilor conectate și ce înseamnă, limita de cereri, ce se păstrează și cât timp.

Specificația API (JSON)

Erorile au formatul {"title": "…", "status": 4xx, "code": "…"} (în română, gata de afișat sau de jurnalizat).

HTTP Cod Înseamnă Ce faci
401 API_AUTH_REQUIRED lipsesc antetele trimite X-Ezif-Key, X-Ezif-Timestamp, X-Ezif-Signature
401 API_STALE ora cererii diferă cu peste 5 minute sincronizează ceasul serverului (NTP)
401 API_SIGNATURE_INVALID semnătura nu corespunde verifică secretul, metoda, calea (fără ?…) și corpul exact trimis
401 API_KEY_INVALID cheia nu există sau e revocată cere o cheie nouă Administratorului firmei
403 MISSING_SCOPE cheia nu are dreptul (câmpul scope îl numește) Administratorul îl bifează în Setările aplicației
403 SERIES_NOT_ALLOWED seria cerută nu e permisă cheii lasă series gol (seria cheii)
403 API_DOMAIN_NOT_ALLOWED firma are domenii autorizate și aplicația nu e în listă X-Ezif-Site sau lista de domenii
403 API_OWNER_NO_RIGHTS utilizatorul cheii nu mai are dreptul de emitere treci cheia pe utilizator tehnic
404 PROFORMA_NOT_FOUND proforma nu există (sau nu e o proformă cu plată) verifică id-ul / external_id
409 PROFORMA_INVOICED proforma e deja plătită și facturată nu mai trimite plăți pe ea
409 PROFORMA_CANCELLED · NOT_CANCELLABLE proforma anulată / nu se poate anula (are încasări) —
422 INVALID_SERIES, INVALID_VALID_DAYS, INVALID_PERIOD, INVALID_VAT_RATE, PARTNER_ADDRESS date invalide corectează câmpul numit în mesaj
429 RATE_LIMITED peste 120 de cereri pe minut pe cheie așteaptă Retry-After secunde
502 EMAIL_FAILED e-mailul (retrimiterea) nu a plecat adresa clientului / serverul de e-mail al firmei

Ce se păstrează

Ce Unde Cât
Cererile aplicației (ora, cheia, calea, codul, motivul respingerii) Integrări → API și chei → Ultimele cereri 30 de zile
Livrările webhook Integrări → Livrări webhook 30 de zile în listă
Operațiile (proforme, plăți, facturi, setări, revocări) Administrare → Jurnal de audit permanent
Documentele emise și încasările Vânzări, registrul verificabil permanent (imuabile după emitere)

Documentația aplicației eZif 0.42.6.