Solução de problemas de conectores

Saiba como solucionar problemas comuns do Connector.

Visão geral

Ao usar conectores, você pode encontrar problemas que exigem algum conhecimento dos detalhes técnicos de como os conectores funcionam. Este guia o ajudará a entender esses detalhes, além de encontrar soluções para problemas comuns de conectores e interpretar códigos de erro.

Problemas comuns dos conectores

Por que meu conector está off-line?

Se o seu conector mostrar que está off-line, há um problema com a conexão com o servidor. Isso pode ocorrer por dois motivos:1. Credenciais incorretas Verifique novamente os campos de entrada ao configurar o conector e certifique-se de que as informações estejam corretas. Se não tiver certeza, examine a documentação do sistema de terceiros e as credenciais de sua conta para verificação. Os campos podem diferenciar maiúsculas de minúsculas, portanto, certifique-se de que os valores inseridos sejam idênticos aos fornecidos.2. Problemas com o sistema de terceiros Os problemas de conexão podem estar no próprio sistema de terceiros e em um problema com o servidor deles. Entre em contato com o administrador do sistema para obter mais informações sobre possíveis problemas de conexão.

Se você ainda não configurou seu conector ou precisa de uma atualização, consulte nosso guia sobre Como configurar um conector para obter um passo a passo.

O que acontece se a função do meu conector falhar?

Se uma função do conector falhar, será exibida uma mensagem de erro e o sistema não tentará repetir a chamada. As falhas podem ocorrer devido a vários motivos comuns:

1. O sistema externo não responde à solicitação de API, seja por falta de resposta ou por exceder o tempo máximo de execução do conector.
2. O Host do Conector está off-line.

Por que o Connector Host está desconectado?

Você pode ver os status do host do conector em: https://[your-instance].tulip.co/account-settings/connectors-settings

Se estiver usando um host de conector no local, verifique se há problemas com seu servidor ou host.

Para aqueles que usam o Tulip Cloud Connector Host, esse host de conector deve estar sempre on-line. O Cloud Connector Host é um serviço gerenciado pela Tulip. Entre em contato com suppport@tulip.co se ele não estiver disponível.

Onde posso encontrar endpoints de API para o meu sistema?

A busca por "API Docs [nome do sistema]" quase sempre resultará em uma página voltada para o desenvolvedor com todos os endpoints de API e detalhes sobre especificações como autenticação e parâmetros.

Se estiver usando a Tulip Table API, veja a documentação em: https://[your-instance].tulip.co/apiDocs

O que é autorização básica/portadora?

A autorização básica e de portador são cabeçalhos padrão usados para acesso.

O cabeçalho "Authorization" terá o valor "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==" ou "Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==". Os clientes TLS e não TLS podem usar a autorização básica. O portador deve ser apenas para TLS.

O que é X-auth-token, x-authentication, x-authentication-token?

Todos esses são exemplos de cabeçalhos não regulamentados que são frequentemente usados para autenticação. O "X" indica que esses cabeçalhos não são padrão.

Consulte a documentação do seu sistema para obter mais detalhes sobre como configurá-los.

Por que minha solicitação HTTP GET ou POST não está retornando dados?

Se o seu HTTP GET ou POST não retornar nenhum dado, examine o cabeçalho content-type. Esse cabeçalho geralmente é necessário, mas nem sempre, para esses tipos de solicitação.

Por que não consigo ver a saída da minha consulta SQL?

As colunas de saída devem ser mapeadas para ver qualquer resposta (onde http mostrará a resposta inteira sem nenhuma saída mapeada)

Por que minhas saídas não estão sendo usadas?

Observe o formato de suas saídas. As saídas diferenciam maiúsculas de minúsculas e geralmente usam CamelCase ou lowerCamelCase.

Os conectores HTTP também usam a notação de pontos para objetos aninhados nos resultados. Para saber mais sobre como entender a notação de pontos, leia este guia externo aqui.

Códigos de erro dos conectores

HTTP

Os códigos HTTP são expansivos e seus prefixos indicam o tipo de solicitação.

4xx - Solicitação ruim2xx - Solicitação boa3xx - Solicitação mista

Consulte este guia de códigos de erro HTTP para obter mais informações.

SQL

Com o SQL, geralmente os códigos de erro vêm das próprias solicitações.

Consulte este guia de códigos de erro do SQL para obter mais informações.

Leitura adicional

• Uma visão geral dos conectores HTTP

Encontrou o que estava procurando?

Você também pode ir para community.tulip.co para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!