Kodet e gabimit dhe zarfi i gabimit

1. Çdo 4xx dhe 5xx kthen { "error": { type, code, message, param?, doc_url, request_id, errors? } }.
2. Vendos sipas type nëse ka kuptim riprovimi, dhe lidh code me sistemin tënd.
3. param tregon fushën problematike, p.sh. lines.0.vat_rate; errors[] shfaqet kur janë disa.
4. Regjistro request_id në çdo gabim — na lejon të gjejmë kërkesën e saktë në regjistrat tanë.

json
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "Datele trimise nu sunt valide.",
    "param": "lines.0.vat_rate",
    "doc_url": "https://4invoices.net/ro/api-dezvoltatori#errors",
    "request_id": "req_8a893f2f33d4472da8d6e144",
    "errors": [
      { "param": "lines.0.vat_rate", "message": "VAT rate must be a percent (21), not a fraction", "type": "value_error" }
    ]
  }
}

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• rate_limit_error dhe dy llojet upstream riprovohen. authentication_error, permission_error dhe invalid_request_error nuk korrigjohen me riprovim.
• Kthehet gjithashtu 404 për një id që i përket një tjetri klient: ne nuk konfirmojmë kurrë që ekzistojnë të dhënat e dikujt tjetër.
• 409 idempotency_key_reuse do të thotë që ke ripërdorur një çelës me body tjetër. Mos e detyro: kontrollo çfarë është lëshuar tashmë.
• doc_url i çdo gabimi të dërgon drejt e te seksioni i gabimeve të kësaj dokumentacioni.
• Mesazhet janë në rumanisht sepse API shërben një rrjedhë fiskale rumune; mos analizo message, vendos sipas code.