Try Catch

Adicione uma atividade Try Catch a um fluxo de trabalho de API no Studio Web para lidar com exceções de falhas de API, dados inválidos ou erros inesperados com ações de fallback.

A atividade Try Catch fornece manuseio de exceção estruturado dentro de fluxos de trabalho. Use-o para definir ações de fallback para falhas de API, dados inválidos ou erros inesperados.

Como usar a atividade Try Catch

Para adicionar uma atividade Teste de Captura ao seu fluxo de trabalho:

1. Em sua tela de designer de fluxo de trabalho de API, selecione o ícone de mais (+). O menu Adicionar atividade aparece.
2. Selecione Mais... e, em seguida, Try Catch.
3. No painel Propriedades , forneça um nome para o seu erro.
4. Adicione atividades ao bloco Try . Estas são as atividades monitoradas quanto a erros.
5. Defina a lógica de tratamento de erros no bloco Catch . Se qualquer etapa do bloco Try falhar, a execução faz a transição para o fluxo Catch .
6. Depure o fluxo de trabalho para executar a atividade e gerar campos de saída para uso posterior.

Acessando detalhes do erro

Quando ocorre um erro no bloco Try , a atividade Try-Catch expõe detalhes estruturados do erro. Para acessar os detalhes do erro, use $context.outputs.Try_Catch_X.error ou $error.

O objeto error mantém uma estrutura consistente, da seguinte maneira:

"Try_Catch_1": {
        "error": {
          "type": "<runtime error source>",
          "title": "<summary error message>",
          "status": <response status code>,
          "detail": "<detailed error message",
          "data": {},
        }
      }

Os detalhes do erro são:

• tipo— Indica a origem do erro em runtime.
• título—Fornece um resumo de erro conciso.
• status—O código de status HTTP (se aplicável).
• Detalhe— oferece uma explicação detalhada do erro.
• data— Inclui metadados adicionais sobre a tarefa com falha. Este campo pode não ser sempre preenchido.

Você pode fazer referência a essas propriedades para criar respostas de erro estruturadas ou disparar alertas.