Atividade HTTP Request

Visão geral

A atividade HTTP Request permite que você realize solicitações HTTP para uma API especificada usando a configuração de conector e conexão existentes.

Por que escolher HTTP Request em vez de outras atividades para um determinado conector?

Com a HTTP Request você pode fazer solicitações para qualquer ponto de extremidade da API de um fornecedor, acessando todos os seus recursos. Isso significa que agora você pode ir além das funcionalidades de atividades predefinidas oferecidas por um conector do Integration Service.

Observação: a atividade HTTP Request agora está disponível para apenas uma parte dos conectores do Integration Service. Em breve ela será expandida para todos os outros conectores compatíveis com JSON. Verifique as notas de versão do pacote de atividades individuais para saber quando a atividade é habilitada para um conector específico. Também está disponível por padrão para qualquer conector personalizado criado com o Construtor de Conector.

Limitações

• Os conectores criados em APIs SOAP ou SDKs não são compatíveis com essa atividade.
• As ações de download ou upload de arquivo não são compatíveis no momento.
• Essa atividade atualmente só atende application/json para tipo de conteúdo.

Compatibilidade do projeto

As atividades HTTP Request estão disponíveis no Studio Web e em projetos do Studio Desktop Windows e multiplataforma.

Configuração

• ID de conexão - A conexão estabelecida no Integration Service. Acesse o menu suspenso para escolher, adicionar ou gerenciar conexões. Essa conexão é a mesma que para quaisquer outras atividades nesse conector
• Método - O método de solicitação a ser usado ao chamar a API. Os seguintes verbos HTTP são compatíveis:
  • GET — método usado para solicitar dados de um recurso especificado.
  • DELETE - Método usado para excluir dados de um recurso especificado.
  • PATCH — método usado para aplicar modificações parciais a um recurso.
  • POST — método usado para enviar dados para o servidor.
  • PUT — Método usado para enviar dados ao servidor para atualizar um recurso.
• URL base - Indica a URL base para a solicitação. Isso é somente leitura e fornecido pelo conector. Se seu ponto de extremidade exigir uma URL/caminho base diferente, provavelmente será uma solicitação de alteração ou uma solicitação HTTP personalizada por meio do pacote de atividades da Web.
• Ponto de extremidade - Indica o caminho do ponto de extremidade para a solicitação. Esse campo será concatenado ao campo URL base somente leitura.
• Cabeçalhos - Os cabeçalhos de solicitação. Use o Editor de dicionário para adicionar cabeçalhos. Os cabeçalhos padrão enviados pelo conector ao fornecedor já são exibidos na caixa de informações. Esse campo de dicionário de cabeçalhos permite que você adicione outros cabeçalhos.
• Parâmetros de consulta - Os parâmetros de consulta. Use o Editor de dicionário para adicionar novos parâmetros.
  • Exemplo: query value "select * from Vendor"(para QuickBooks Online).
• Corpo - Insira uma carga do JSON que é enviada ao ponto de extremidade fornecido.

Propriedades adicionais

Saída

• Conteúdo da resposta - A resposta recebida da solicitação HTTP. Este é um JSON e pode ser desserializado.
• Status da resposta - o código de status recebido da solicitação HTTP, como uma variável inteira.
• Cabeçalhos de resposta - A resposta recebida da solicitação HTTP.