Solução de problemas
Sintoma, causa e o que fazer.
O contêiner não inicia
| Mensagem de log (resumo) | Causa | Correção |
|---|---|---|
| Reading config | POSTGRES_ADDRESS_HOST, POSTGRES_PASSWORD ou HUMAN_API_ACCESS_KEY está ausente ou vazia | Defina a variável |
POSTGRES_PASSWORD must not contain… | Espaço em branco, aspas, barra invertida ou caracteres de controle | Use outra senha |
| Qualquer outra variável citada no erro | Foi definida uma variável fora da configuração suportada | Remova a variável |
| Downloading attribute catalog | Saída para human-token-assets.unico.app bloqueada, ou sem resposta em 10 segundos | Libere o HTTPS de saída para ele |
database "…" does not exist | O banco indicado em POSTGRES_DATABASE, human_plugin por padrão, não foi criado | Crie o banco ou defina POSTGRES_DATABASE com o que você criou |
| Connecting to or preparing the database | PostgreSQL inacessível, credenciais ou modo SSL incorretos, ou o role não pode criar tabelas | Verifique a conexão com o banco de dados e as permissões do role |
Requisições
| Sintoma | Causa | Correção |
|---|---|---|
401 com {"message":"","details":[]} | A Unico recusou a chave de acesso: ausente, incorreta ou não mais válida | Verifique HUMAN_API_ACCESS_KEY e reinicie o Human Plugin. Se a chave estiver certa, peça à Unico para confirmar que ela está habilitada |
400 MISSING_CREDENTIAL_TYPE | credential está ausente, ou é um objeto com strings vazias | Envie um documento, ou null / {} |
400 INVALID_REQUEST com um corpo aparentemente válido | Um campo reservado pelo Human Plugin, outra grafia de clientId, correlationId ou credential (como client_id), ou um valor que não é string em um deles | Use os nomes exatos dos campos de Criar um processo |
400 INVALID_CLIENT_ID (ou outro campo) | Acima do limite de bytes, caracteres de controle ou espaços nas extremidades | Remova os espaços e reduza o tamanho |
400 REQUEST_TOO_LARGE | Corpo acima de 2 MiB | Reduza o tamanho da imagem |
409 CORRELATION_ID_ALREADY_USED | Outro processo já tem esse correlationId, inclusive um que falhou | Envie um novo correlationId, único |
422 ATTRIBUTE_TYPE_NOT_SUPPORTED | Código fora do catálogo, ou com maiúsculas/minúsculas incorretas | Use um código exato do catálogo |
4xx com um message desconhecido | O fluxo recusou a requisição: o fluxo, a imagem ou um campo do fluxo | Veja Recusas |
502 UPSTREAM_UNAVAILABLE em toda criação | HTTPS de saída bloqueado | Verifique a saída de rede e a chave de acesso. Para novas tentativas, veja Erros e novas tentativas |
503 DATABASE_UNAVAILABLE | PostgreSQL inacessível | Verifique o banco de dados. A verificação de prontidão também falha |
404 PROCESS_NOT_FOUND para um processo conhecido | Instalação ou banco incorretos, ou id malformado | Confirme o id e qual Human Plugin você está chamando |
Resultados
| Sintoma | Causa |
|---|---|
PROCESS_STATE_FINISHED, mas a pessoa não correspondeu | Finalizado inclui um resultado negativo. Leia data |
data.ndocs ausente | Não finalizado, captura sem prova de vida, correspondência negativa, ou não foi possível calcular a inteligência. Leia novamente. Veja Inteligência |
token / link da jornada ausentes no GET | São devolvidos apenas na criação |
PROCESS_STATE_FAILED com data: {} | O processo terminou sem resultado. Veja Ciclo de vida do processo |
| Um processo pendente nunca avança | Nada o atualiza, exceto um GET. Faça polling |