Gestione Errori & Codici di Risposta

{
  "success": true,
  "message": "Notifica accodata con successo",
  "notification_id": "uuid-notification-123",
  "scheduled_time": "2024-12-25T10:30:00Z"
}

{
  "templates": [
    {
      "id": "template_001",
      "name": "welcome_user",
      "status": "approved"
    }
  ],
  "total": 1
}

{
  "success": true,
  "message": "Template creato con successo",
  "template": {
    "id": "new_template_123",
    "name": "order_confirmation",
    "status": "pending"
  }
}

{
  "error": "validation_failed",
  "message": "Campo richiesto mancante",
  "details": {
    "field": "contact.number",
    "reason": "Questo campo è richiesto"
  },
  "request_id": "req_123456789"
}

{
  "error": "validation_failed",
  "message": "Formato parametro non valido",
  "details": {
    "field": "datetime_sending",
    "provided": "25-12-2024",
    "expected_format": "ISO 8601 (YYYY-MM-DDTHH:MM:SS)",
    "example": "2024-12-25T10:30:00"
  },
  "request_id": "req_123456790"
}

{
  "error": "unauthorized",
  "message": "Chiave di accesso non valida o scaduta",
  "details": {
    "reason": "La chiave di accesso fornita non è valida o è stata revocata"
  },
  "request_id": "req_123456793"
}

{
  "error": "forbidden",
  "message": "Permessi insufficienti per questa risorsa",
  "details": {
    "reason": "La tua chiave API non ha il permesso di creare template"
  },
  "request_id": "req_123456795"
}

{
  "error": "template_not_found",
  "message": "Template 'welcome_user' non trovato o non approvato",
  "details": {
    "template_name": "welcome_user",
    "language": "it_IT",
    "suggestion": "Controlla il nome del template e lo stato di approvazione"
  },
  "request_id": "req_123456797"
}

{
  "error": "template_not_approved",
  "message": "Il template non è in stato approvato",
  "details": {
    "template_name": "pending_template",
    "current_status": "pending",
    "required_status": "approved"
  },
  "request_id": "req_123456799"
}

{
  "error": "rate_limit_exceeded",
  "message": "Troppe richieste. Riprova tra 60 secondi",
  "details": {
    "limit": 100,
    "window": "1 ora",
    "reset_time": "2024-12-20T16:30:00Z"
  },
  "retry_after": 60,
  "request_id": "req_123456801"
}

{
  "error": "internal_error",
  "message": "Si è verificato un errore imprevisto",
  "details": {
    "reason": "Errore interno del server"
  },
  "request_id": "req_123456803"
}

{
  "error": "service_unavailable",
  "message": "Servizio WhatsApp temporaneamente non disponibile",
  "details": {
    "service": "whatsapp_gateway",
    "estimated_recovery": "2024-12-20T16:00:00Z"
  },
  "request_id": "req_123456804"
}

{
  "error": "service_unavailable",
  "message": "Servizio temporaneamente non disponibile per manutenzione",
  "details": {
    "maintenance_window": "2024-12-20T02:00:00Z to 2024-12-20T04:00:00Z"
  },
  "request_id": "req_123456805"
}