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.
- Mapeie os campos de status HTTP para as saídas.
- 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.
- Crie um novo acionador para executar o Connector Error Handling.
- 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
::: - 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