Captura de erros do conector HTTP

Entenda os casos de uso da captura de um erro do HTTP API Connector, bem como a forma de registrar o erro e tentar novamente a função do conector.

Tipos de erros do conector HTTP

Incluído no padrão do protocolo HTTP está o requisito para um código de resposta e uma mensagem do servidor, conhecidos como Código de Resposta HT TP e Mensagem de Resposta HTTP. Com isso, há classes ou categorias de código de resposta HTTP padrão para ajudar os usuários finais a identificar intuitivamente o tipo de erro ocorrido.
Essas classes de código incluem o seguinte: * 1xx - resposta informativaA solicitação foi recebida, continuando o processo * 2xx - bem-sucedidaA solicitação foi recebida, compreendida e aceita com êxito * 3xx - redirecionamentoÉ necessário tomar outras medidas para concluir a solicitação * 4xx - erro do clienteA solicitação contém sintaxe incorreta ou não pode ser atendida * 5xx - erro do servidorO servidor não conseguiu atender a uma solicitação aparentemente válida

O código de erro mais comum que se pode encontrar é 404 - Não encontrado ou 500 - Erro interno do servidor. Esses códigos de erro podem indicar que o servidor do sistema externo está inativo, que há manutenção em andamento, que há um problema com o serviço ou que há um problema de rede.

Exemplo: Captura de erros HTTP em um aplicativo

O exemplo a seguir detalha como configurar um aplicativo para exibir erros de função do conector HTTP.

Criar a função do conector

No construtor da Função do Conector, você pode mapear o Código de Erro HTTP e a Mensagem de Erro na configuração Output do conector. Isso passará o Código de Erro HTTP e a Mensagem de Erro como saídas da função do conector a serem usadas posteriormente nos aplicativos Tulip.

1. Mapeie os campos de status HTTP para as saídas.
2. Dê às saídas um nome claro e distinto e execute novamente a função do conector para testar se a saída aparece corretamente.

Isso se parecerá com o exemplo a seguir:

Criar um aplicativo para lidar com erros do conector

Use as informações das saídas do conector em aplicativos para executar o tratamento de erros do conector.

Executar o conector em um acionador de aplicativo

Crie uma ação de acionamento com Run Connector Function. Selecione o conector e a função que você acabou de criar e salve o resultado como uma variável.

O código de resposta HTTP e a mensagem agora estão disponíveis como referência na nova variável do aplicativo.

Visualize a resposta do conector em um aplicativo

Coloque um widget Variable em uma etapa do aplicativo que exiba toda a variável Connector Response.

Criar gatilho de tratamento de erros do Connector

Em seguida, você pode usar o código de resposta HTTP para executar o tratamento de erros no nível do aplicativo em uma condição de acionador subsequente.

1. Crie um novo acionador para executar o Connector Error Handling.
2. Crie uma condição que procure o código de resposta HTTP que esteja incorreto. Neste exemplo, a condição procura respostas que não sejam iguais a 200.:::(Info) (Observação) Muitos sistemas usam o código de resposta 200 como uma boa resposta, mas é melhor verificar com o provedor do ponto de extremidade da API ou com o departamento de TI se todas as boas respostas serão apenas do código 200 :::
3. Crie uma ação de acionamento para ocorrer quando a condição for atendida, quando o código de resposta HTTP for ruim.

Esta é a aparência disso no aplicativo:

Leitura adicional

• Como criar e configurar uma função do conector HTTP
• Como formatar as saídas do conector HTTP
• Uso de conectores HTTP em aplicativos