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 HTTP 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 informativaAsolicitação foi recebida, continuando o processo* 2xx - bem-sucedidaAsolicitação foi recebida, compreendida e aceita com êxito* 3xx - redirecionamentoÉ necessário executar outraação para concluir a solicitação* 4xx - erro do clienteAsolicitação contém sintaxe incorreta ou não pode ser atendida* 5xx - erro do servidorOservidor não conseguiu atender a uma solicitação aparentemente válida

O código de erro mais comum que pode ser encontrado é 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.

O resultado será parecido com o seguinte exemplo:

Criar um aplicativo para tratar os 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 de 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 conector

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) (Note)
   Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 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
• Como usar conectores HTTP em aplicativos