Códigos de error de la API de análisis de sangre

Última actualización: 8 de septiembre de 2026

Comprendiendo las respuestas de error de la API y cómo manejarlas.

Descripción General

La API devuelve respuestas de error estandarizadas con códigos de error específicos para ayudarte a identificar y resolver problemas rápidamente.

Formato de Respuesta de Error

{
  "status": "error",
  "error": {
    "code": "AUTH_1001",
    "message": "Credenciales de autenticacion faltantes",
    "details": "Los campos 'username' y 'password' son requeridos",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

Errores de Autenticación (1000-1099)

Código	HTTP	Mensaje	Solución
`AUTH_1001`	401	Credenciales de autenticación faltantes	Incluye usuario y contraseña en la solicitud
`AUTH_1002`	401	Usuario o contraseña inválidos	Verifica que las credenciales sean correctas
`AUTH_1003`	403	Cuenta temporalmente bloqueada	Espera antes de reintentar o contacta con soporte

Errores de Cuota (1100-1199)

Código	HTTP	Mensaje	Solución
`QUOTA_1101`	403	Cuota de API insuficiente	Compra más créditos o verifica la cuota
`QUOTA_1102`	429	Cuota de API excedida	Espera la renovación de cuota o mejora el plan

Errores de Validación (2000-2099)

Código	HTTP	Mensaje	Solución
`VAL_2001`	400	Ningún archivo subido	Incluye un archivo en la solicitud
`VAL_2002`	400	Formato de archivo inválido	Usa formatos soportados: PDF, PNG, JPG, WEBP
`VAL_2003`	400	Múltiples archivos PDF no permitidos	Sube un solo PDF o varias imágenes
`VAL_2004`	400	PDF e imágenes no pueden mezclarse	Sube PDF o imágenes, no ambos

Errores de Procesamiento (3000-3099)

Código	HTTP	Mensaje	Solución
`PROC_3001`	500	Fallo en el procesamiento del documento	Verifica la calidad de la imagen, reintenta
`PROC_3006`	504	Timeout en el procesamiento	Reduce el tamaño del archivo o divide en múltiples solicitudes

Errores del Servidor (5000-5099)

Código	HTTP	Mensaje	Solución
`SRV_5001`	500	Error interno del servidor	Reintenta, contacta con soporte si persiste
`SRV_5002`	503	Servicio temporalmente no disponible	Espera y reintenta con backoff exponencial

Mejores Prácticas de Manejo de Errores

Recomendaciones

Siempre verifica el campo status - Las respuestas exitosas tienen "status": "success"
Implementa lógica de reintentos para errores transitorios (5xx) con backoff exponencial
Registra códigos de error para depuración y monitoreo
Muestra mensajes amigables basados en los códigos de error