Devolver tarefa

A tarefa Return permite personalizar as mensagens de erro correspondentes aos códigos de resposta HTTP retornados durante uma falha na execução da integração.

É possível modificar ou personalizar mensagens de erro para os seguintes códigos de resposta HTTP:
Código HTTP Código canônico
400 INVALID_ARGUMENT
400 OUT_OF_RANGE
401 UNAUTHENTICATED
403 PERMISSION_DENIED
404 NOT_FOUND
409 ALREADY_EXISTS
429 RESOURCE_EXHAUSTED
499 CANCELLED

Configuração da tarefa Return

Para configurar a tarefa Return:

  1. Na interface da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para conferir a lista de tarefas disponíveis.
  5. Clique e coloque o elemento de tarefa Return no editor de integração.
  6. Clique no elemento de tarefa Return do designer para abrir o painel de configuração de tarefa Return.
  7. Configure os campos exibidos usando as Propriedades de configuração para a tarefa, conforme detalhado nas tabelas abaixo.

    As alterações nas propriedades são salvas automaticamente.

Propriedades de configuração

Confira na tabela a seguir as propriedades de configuração da tarefa Return.

Propriedade Tipo de dado Descrição
HTTP code Inteiro O código HTTP 4XX para o qual você quer personalizar a mensagem de erro.
Customized return message String A mensagem de erro personalizada para o código HTTP especificado.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.