Fehlerbehandlung & Antwortcodes

{
  "success": true,
  "message": "Benachrichtigung erfolgreich in Warteschlange eingereiht",
  "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 erfolgreich erstellt",
  "template": {
    "id": "new_template_123",
    "name": "order_confirmation",
    "status": "pending"
  }
}

{
  "error": "validation_failed",
  "message": "Erforderliches Feld fehlt",
  "details": {
    "field": "contact.number",
    "reason": "Dieses Feld ist erforderlich"
  },
  "request_id": "req_123456789"
}

{
  "error": "validation_failed",
  "message": "Ungültiges Parameterformat",
  "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": "Ungültiger oder abgelaufener Zugriffsschlüssel",
  "details": {
    "reason": "Der bereitgestellte access_key ist ungültig oder wurde widerrufen"
  },
  "request_id": "req_123456793"
}

{
  "error": "forbidden",
  "message": "Unzureichende Berechtigungen für diese Ressource",
  "details": {
    "reason": "Ihr API-Schlüssel hat keine Berechtigung zum Erstellen von Templates"
  },
  "request_id": "req_123456795"
}

{
  "error": "template_not_found",
  "message": "Template 'welcome_user' nicht gefunden oder nicht genehmigt",
  "details": {
    "template_name": "welcome_user",
    "language": "de_DE",
    "suggestion": "Überprüfen Sie den Template-Namen und Genehmigungsstatus"
  },
  "request_id": "req_123456797"
}

{
  "error": "template_not_approved",
  "message": "Template ist nicht im genehmigten Status",
  "details": {
    "template_name": "pending_template",
    "current_status": "pending",
    "required_status": "approved"
  },
  "request_id": "req_123456799"
}

{
  "error": "rate_limit_exceeded",
  "message": "Zu viele Anfragen. Versuchen Sie es in 60 Sekunden erneut",
  "details": {
    "limit": 100,
    "window": "1 Stunde",
    "reset_time": "2024-12-20T16:30:00Z"
  },
  "retry_after": 60,
  "request_id": "req_123456801"
}

{
  "error": "internal_error",
  "message": "Ein unerwarteter Fehler ist aufgetreten",
  "details": {
    "reason": "Interner Serverfehler"
  },
  "request_id": "req_123456803"
}

{
  "error": "service_unavailable",
  "message": "WhatsApp-Service vorübergehend nicht verfügbar",
  "details": {
    "service": "whatsapp_gateway",
    "estimated_recovery": "2024-12-20T16:00:00Z"
  },
  "request_id": "req_123456804"
}

{
  "error": "service_unavailable",
  "message": "Service vorübergehend für Wartung nicht verfügbar",
  "details": {
    "maintenance_window": "2024-12-20T02:00:00Z to 2024-12-20T04:00:00Z"
  },
  "request_id": "req_123456805"
}