Manejo de Errores y Códigos de Respuesta

{
  "success": true,
  "message": "Notificación puesta en cola correctamente",
  "notification_id": "uuid-notificacion-123",
  "scheduled_time": "2024-12-25T10:30:00Z"
}

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

{
  "success": true,
  "message": "Plantilla creada correctamente",
  "template": {
    "id": "new_template_123",
    "name": "order_confirmation",
    "status": "pending"
  }
}

{
  "error": "validation_failed",
  "message": "Campo requerido faltante",
  "details": {
    "field": "contact.number",
    "reason": "Este campo es requerido"
  },
  "request_id": "req_123456789"
}

{
  "error": "validation_failed",
  "message": "Formato de parámetro inválido",
  "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": "validation_failed",
  "message": "Formato de número de teléfono inválido",
  "details": {
    "field": "contact.number",
    "provided": "+34-666-033-135",
    "expected_format": "Solo números, sin + ni espacios",
    "example": "34666033135"
  },
  "request_id": "req_123456791"
}

{
  "error": "validation_failed",
  "message": "La hora programada debe ser en el futuro",
  "details": {
    "field": "datetime_sending",
    "provided": "2024-12-20T10:00:00",
    "current_time": "2024-12-20T15:30:00Z"
  },
  "request_id": "req_123456792"
}

{
  "error": "unauthorized",
  "message": "Clave de acceso inválida o expirada",
  "details": {
    "reason": "La access_key proporcionada no es válida o ha sido revocada"
  },
  "request_id": "req_123456793"
}

{
  "error": "unauthorized",
  "message": "Clave de acceso faltante",
  "details": {
    "reason": "El parámetro access_key es requerido en la URL"
  },
  "request_id": "req_123456794"
}

{
  "error": "forbidden",
  "message": "Permisos insuficientes para este recurso",
  "details": {
    "reason": "Tu clave API no tiene permiso para crear plantillas"
  },
  "request_id": "req_123456795"
}

{
  "error": "template_not_found",
  "message": "Plantilla 'welcome_user' no encontrada o no aprobada",
  "details": {
    "template_name": "welcome_user",
    "language": "es_ES",
    "suggestion": "Verifica el nombre de la plantilla y su estado de aprobación"
  },
  "request_id": "req_123456797"
}

{
  "error": "template_not_approved",
  "message": "La plantilla no está en estado aprobado",
  "details": {
    "template_name": "pending_template",
    "current_status": "pending",
    "required_status": "approved"
  },
  "request_id": "req_123456799"
}

{
  "error": "rate_limit_exceeded",
  "message": "Demasiadas solicitudes. Inténtalo de nuevo en 60 segundos",
  "details": {
    "limit": 100,
    "window": "1 hora",
    "reset_time": "2024-12-20T16:30:00Z"
  },
  "retry_after": 60,
  "request_id": "req_123456801"
}

{
  "error": "internal_error",
  "message": "Ocurrió un error inesperado",
  "details": {
    "reason": "Error interno del servidor"
  },
  "request_id": "req_123456803"
}

{
  "error": "service_unavailable",
  "message": "Servicio temporalmente no disponible por mantenimiento",
  "details": {
    "maintenance_window": "2024-12-20T02:00:00Z to 2024-12-20T04:00:00Z"
  },
  "request_id": "req_123456805"
}

async function makeAPIRequest(url, data, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch(url, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(data)
      });

      const result = await response.json();

      if (response.ok) {
        return result;
      }

      if (response.status === 429) {
        const retryAfter = result.retry_after || 60;
        await sleep(retryAfter * 1000);
        continue;
      }

      if ([500, 502, 503].includes(response.status)) {
        if (attempt < maxRetries) {
          await sleep(Math.pow(2, attempt) * 1000);
          continue;
        }
      }

      throw new APIError(result.error, result.message, response.status);

    } catch (error) {
      if (attempt === maxRetries) throw error;
      await sleep(Math.pow(2, attempt) * 1000);
    }
  }
}