Solución de problemas
Síntoma, causa y qué hacer.
El contenedor no arranca
| Mensaje del log (resumen) | Causa | Solución |
|---|---|---|
| Reading config | Falta POSTGRES_ADDRESS_HOST, POSTGRES_PASSWORD o HUMAN_API_ACCESS_KEY, o está vacía | Defínala |
POSTGRES_PASSWORD must not contain… | Espacios en blanco, comillas, barras invertidas o caracteres de control | Use otra contraseña |
| Cualquier otra variable citada en el error | Se definió una variable fuera de la configuración admitida | Elimínela |
| Downloading attribute catalog | Salida hacia human-token-assets.unico.app bloqueada, o sin respuesta en 10 segundos | Permita HTTPS de salida hacia ese host |
database "…" does not exist | La base de datos indicada en POSTGRES_DATABASE, human_plugin por defecto, no fue creada | Cree la base de datos, o defina POSTGRES_DATABASE con la que creó |
| Connecting to or preparing the database | PostgreSQL inaccesible, credenciales o modo SSL incorrectos, o el rol no puede crear tablas | Revise la conexión a la base de datos y los permisos del rol |
Solicitudes
| Síntoma | Causa | Solución |
|---|---|---|
401 con {"message":"","details":[]} | Unico rechazó la clave de acceso: falta, es incorrecta o ya no es válida | Revise HUMAN_API_ACCESS_KEY y reinicie Human Plugin. Si la clave es correcta, pida a Unico que confirme que está habilitada |
400 MISSING_CREDENTIAL_TYPE | Falta credential, o es un objeto con cadenas vacías | Envíe un documento, o null / {} |
400 INVALID_REQUEST con un cuerpo aparentemente válido | Un campo que Human Plugin reserva, otra grafía de clientId, correlationId o credential (como client_id), o un valor que no es cadena en alguno de ellos | Use los nombres de campo exactos de Crear un proceso |
400 INVALID_CLIENT_ID (u otro campo) | Supera el límite de bytes, tiene caracteres de control o espacios en los extremos | Recorte y acorte el valor |
400 REQUEST_TOO_LARGE | Cuerpo superior a 2 MiB | Reduzca el tamaño de la imagen |
409 CORRELATION_ID_ALREADY_USED | Otro proceso ya tiene ese correlationId, incluso uno fallido | Envíe un correlationId nuevo y único |
422 ATTRIBUTE_TYPE_NOT_SUPPORTED | Código que no está en el catálogo, o con mayúsculas y minúsculas incorrectas | Use un código exacto del catálogo |
4xx con un message desconocido | El flujo rechazó la solicitud: el flujo, la imagen o un campo del flujo | Consulte Rechazos |
502 UPSTREAM_UNAVAILABLE en cada creación | HTTPS de salida bloqueado | Revise la salida de red y la clave de acceso. Para los reintentos, consulte Errores y reintentos |
503 DATABASE_UNAVAILABLE | PostgreSQL inaccesible | Revise la base de datos. La comprobación de readiness también falla |
404 PROCESS_NOT_FOUND para un proceso conocido | Instalación o base de datos equivocada, o un id mal formado | Confirme el id y a qué Human Plugin está llamando |
Resultados
| Síntoma | Causa |
|---|---|
PROCESS_STATE_FINISHED pero la persona no coincidió | Finalizado incluye un resultado negativo. Lea data |
Falta data.ndocs | No finalizó, es una captura no viva, hubo una coincidencia negativa, o no fue posible calcular la inteligencia. Vuelva a leer. Consulte Inteligencia |
Faltan token / link del Journey en GET | Solo se devuelven en la creación |
PROCESS_STATE_FAILED con data: {} | El proceso terminó sin resultado. Consulte Ciclo de vida del proceso |
| Un proceso pendiente nunca avanza | Nada lo actualiza salvo un GET. Consúltelo periódicamente (polling) |