Integração e API
O que significa este erro de integração?
Encontre o código de erro, verifique as credenciais e o ambiente e recolha as informações corretas para suporte.
Equipa Toden · 2 min de leitura · Português
Nesta página
Resposta curta
Utilize o estado HTTP e o código de erro estável para identificar o problema. Verifique o produto, o tipo de chave e o ambiente corretos antes de tentar novamente. Uma falha de autenticação, uma entrada rejeitada e uma recusa de verificação do cliente são situações diferentes.
Comece pelas causas comuns
- 401: verificar se a chave ativa completa foi enviada no cabeçalho Bearer esperado. Uma chave revogada não pode ser reutilizada.
- Chave secreta necessária: mova a leitura confidencial para o seu back-end e utilize a chave secreta correta. Não coloque esta chave num navegador para contornar o erro.
- Incompatibilidade de ambiente ou recurso em falta: confirme se a chave, o host, o workflow e o recurso pertencem ao mesmo ambiente.
- Fluxo de trabalho indisponível: verificar publicação, organização e ambiente. Um rascunho não pode atuar como um fluxo publicado.
- Erro de validação: ler a resposta estruturada do campo que necessita de correção. Tente novamente a entrada corrigida em vez de enviar repetidamente o mesmo pedido inválido.
- Taxa limitada: aplicar a retirada e os limites documentados. Novas tentativas imediatas repetidas podem prolongar o problema.
Separe o trabalho pendente do fracasso
Uma verificação em curso significa que o requerente ainda não enviou. O processamento pode significar que as verificações estão a ser executadas ou o fluxo de trabalho está à espera de provas. Um retorno de chamada ao enviar a partir do SDK não significa que a decisão esteja disponível. Prefira as notificações documentadas e a resposta de estado às pesquisas agressivas.
Um erro do sistema ou do fornecedor não é prova de que o requerente falhou as verificações de identidade. Utilize a orientação de erro e o estado atual antes de solicitar outra tentativa.
Se precisar de ajuda
Verifique a página de estado do serviço e contacte Toden com a hora do pedido, ambiente, endpoint, estado HTTP, código de erro e referência do pedido, quando disponível. Edite dados pessoais. Nunca envie uma chave API, um segredo de assinatura ou um link de candidato numa mensagem de apoio geral.
Guias relacionados
Este artigo foi útil?