---
title: "Errores comunes y soluciones"
canonical: "https://docs.holnix.com/space/HW/388169757/Errores%20comunes%20y%20soluciones"
format: markdown
---
Cuando trabajas con la API de Holnix, es posible que encuentres errores que impidan completar tus solicitudes. Esta sección detalla los errores más comunes, las posibles causas y las soluciones recomendadas para que puedas resolverlos de manera eficiente.

## **Errores de autenticación**

### **Token inválido o expirado**

- **Código de error**: 401 Unauthorized
- **Causa**:
- El token JWT proporcionado no es válido.
- El token ha expirado.
- **Solución**:
- Verifica que estás utilizando un token válido.
- Si el token ha expirado, solicita uno nuevo al administrador o al sistema de emisión de tokens.

### **Falta el encabezado de autorización**

- **Código de error**: 400 Bad Request
- **Causa**:
  - No se incluyó el encabezado Authorization en la solicitud.
- **Solución**:
  - Asegúrate de incluir el token en el encabezado, siguiendo este formato:

Authorization: Bearer YOUR_TOKEN

### **Acceso denegado**

- **Código de error**: 403 Forbidden
- **Causa**:
  - El token no tiene permisos para acceder al recurso solicitado.
- **Solución**:
  - Consulta con el administrador para verificar los permisos asociados a tu token.

## **Errores de Solicitudes**

### **Recurso no encontrado**

- **Código de error**: 404 Not Found
- **Causa**:
  - El endpoint solicitado no existe o el recurso (e.g., ISBN, editorial) no fue encontrado.
- **Solución**:
  - Verifica que el endpoint y los parámetros enviados sean correctos.
  - Asegúrate de que el recurso consultado exista en la base de datos.

### **Parámetros inválidos**

- **Código de error**: 400 Bad Request
- **Causa**:
  - Los parámetros enviados son incorrectos o faltan valores obligatorios.
- **Solución**:
  - Revisa la documentación del endpoint para confirmar los parámetros requeridos y su formato.
  - Ejemplo de parámetro correcto:

```json
{
  "isbn": "9781234567890"
}
```

### **Límite de uso excedido**

- **Código de error**: 429 Too Many Requests
- **Causa**:
  - Se realizaron más de 100 solicitudes por minuto desde el mismo token.
- **Solución**:
  - Implementa una lógica de espera o “backoff exponencial” para controlar el número de solicitudes.
  - Reduce la frecuencia de tus solicitudes para respetar los límites de uso.

## **Errores del Servidor**

### **Error interno del servidor**

- **Código de error**: 500 Internal Server Error
- **Causa**:
  - Un problema en el servidor que impide procesar la solicitud.
- **Solución**:
  - Reintenta la solicitud después de unos minutos.
  - Si el problema persiste, contacta al soporte técnico de Holnix.

### **Servicio no disponible**

- **Código de error**: 503 Service Unavailable
- **Causa**:
  - El servidor está sobrecargado o en mantenimiento.
- **Solución**:
  - Verifica el estado del servicio en los canales de comunicación oficiales.
  - Intenta nuevamente después de unos minutos.

## **Errores Específicos de Endpoints**

### **Formato de fecha inválido en **/api/news

- **Código de error**: 400 Invalid date format
- **Causa**:
  - La fecha enviada no sigue el formato esperado (YYYYMMDD).
- **Solución**:
  - Asegúrate de enviar la fecha en el formato correcto. Ejemplo:

### **Número excesivo de ISBNs en **/api/isbns

- **Código de error**: 400 Bad Request
- **Causa**:
  - Se enviaron más ISBNs de los permitidos por solicitud.
- **Solución**:
  - Divide la lista de ISBNs en grupos más pequeños y realiza solicitudes separadas.

## **Buenas Prácticas para Manejar Errores**

1. **Registrar errores**:

- Implementa un sistema de registro para capturar detalles de los errores y facilitar la depuración.

2. **Validar parámetros antes de enviar solicitudes**:

- Verifica que todos los valores cumplen con los requisitos de formato y contenido.

3. **Reintentar solicitudes fallidas**:

- Para errores temporales (500, 503), implementa reintentos con un tiempo de espera creciente.

4. **Consultar la documentación regularmente**:

- Mantén tu implementación actualizada con las últimas especificaciones de la API.

Con esta guía, puedes manejar de manera eficiente los errores más comunes y garantizar que tus integraciones con la API de Holnix sean sólidas y confiables. Si encuentras un error no documentado, consulta al equipo de soporte técnico para obtener asistencia. 😊