Erori API

Această pagină documentează formatele de răspuns pentru erorile returnate de API-ul Targetare.ro, codurile posibile și exemple concrete pentru fiecare situație frecventă.

Formatul general al răspunsului de eroare

{
  "success": false,
  "error": {
    "code": "<cod>",
    "message": "<mesaj>"
  }
}

Exemple de erori

400 - Cerere invalidă

• Parametri lipsă sau invalizi, taxId invalid, dată invalidă etc.

{
  "success": false,
  "error": {
    "code": "400",
    "message": "Invalid taxId"
  }
}

{
  "success": false,
  "error": {
    "code": "400",
    "message": "Missing registration_date parameter"
  }
}

401 - Neautorizat

• Cheie API invalidă, lipsă, IP nepermis

{
  "success": false,
  "error": {
    "code": "401",
    "message": "Unauthorized - Invalid API Key"
  }
}

403 - Acces interzis (abonament)

• Abonament expirat, fără cereri disponibile

{
  "success": false,
  "error": {
    "code": "403",
    "message": "Subscription Error - Subscription expired"
  }
}

404 - Resursă inexistentă

• Companie inexistentă, endpoint inexistent

{
  "success": false,
  "error": {
    "code": "404",
    "message": "Not found"
  }
}

500 - Eroare internă

• Eroare neașteptată pe server

{
  "success": false,
  "error": {
    "code": "500",
    "message": "Internal Server Error"
  }
}

Observații

• Câmpul code este de obicei un cod HTTP sau un identificator de eroare.
• Câmpul message oferă detalii despre motivul erorii.
• Structura este identică pentru toate endpointurile.