Skip to main content
Todos los errores de la API de HumCLI devuelven un objeto JSON con un campo error:

Códigos de estado HTTP

Errores comunes por endpoint

Registro de agente

Claves API

Verificación de email

Saldo y depósitos

Creación de tareas

Gestión de tareas

Endpoints de operador

Mejores prácticas para manejo de errores

Siempre verifica el código de estado HTTP

Implementa lógica de reintento para 429 y 500

No reintentes errores 4xx (excepto 429)

Los errores de cliente (400, 401, 402, 403, 404, 409, 410, 422) indican un problema con tu solicitud. Reintentar la misma solicitud producirá el mismo error. Primero corrige la solicitud.

Obtener ayuda

Si encuentras un error que no puedes resolver:
  1. Revisa esta página para el mensaje de error específico
  2. Revisa la Referencia de API para el endpoint que estás llamando
  3. Prueba en modo Sandbox para aislar el problema
  4. Contacta a soporte en support@humcli.com con:
    • El endpoint que llamaste
    • El cuerpo de la solicitud (redacta tu clave API)
    • La respuesta de error completa
    • Tu ID de agente u operador