Manejo de errores
La API de E3 Stores utiliza códigos de estado HTTP estándar y devuelve mensajes de error descriptivos.
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
200 | OK | Petición exitosa |
400 | Bad Request | Parámetros inválidos o faltantes |
401 | Unauthorized | Autenticación requerida o hash inválido |
404 | Not Found | Recurso no encontrado |
429 | Too Many Requests | Límite de peticiones excedido |
500 | Internal Server Error | Error interno del servidor |
Formato de respuestas de error
{
"status": "error",
"message": "Descripción del error",
"data": null,
"site": 3
}
Errores comunes
401 Unauthorized
- Verificar credenciales de acceso
- Re-autenticar para obtener un nuevo hash
- Incluir el hash en todas las peticiones
400 Bad Request
- Revisar documentación del endpoint
- Verificar parámetros requeridos
- Validar formato de fechas y valores numéricos
404 Not Found
- Verificar que el ID/código existe
- Comprobar la URL del endpoint
- Consultar lista completa de recursos primero
Mejores prácticas
- Implementar reintentos automáticos para errores temporales
- Logging detallado para debugging
- Validación de parámetros antes de enviar peticiones
- Manejo de rate limiting con delays apropiados