Ir para o conteúdo

Conector HTTP v2 no Jitterbit Studio

Resumo

O conector HTTP v2 estabelece acesso por meio do protocolo HTTP ou HTTPS para um serviço como uma API REST, API GraphQL ou formulário web.

O conector HTTP v2 fornece uma interface para criar uma conexão HTTP v2, a base usada para gerar instâncias de atividades HTTP v2. Essas atividades, uma vez configuradas, interagem com um serviço acessível por meio do protocolo HTTP ou HTTPS através da conexão.

O conector HTTP v2 é acessado na guia Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

Para outras formas de se conectar a um serviço web RESTful e uma comparação com o conector HTTP, consulte Considerações sobre conectores baseados em REST.

Importante

Com o lançamento do conector HTTP v2, recomendamos converter conexões e atividades HTTP existentes para HTTP v2. Saiba mais sobre os benefícios do conector HTTP v2 em nosso artigo do blog HTTP v2 ou consulte uma comparação dos recursos dos conectores HTTP e HTTP v2.

A intenção de longo prazo da Jitterbit é descontinuar o conector HTTP, o que será anunciado de acordo com a Política de fim de vida da Jitterbit. No momento, não há cronograma para descontinuação e o conector HTTP permanece totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 quando possível.

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão HTTP v2. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que podem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Se uma instância de atividade pode ser usada como fonte ou destino depende de o serviço web exigir uma solicitação estruturada ou retornar uma resposta estruturada. Cada instância de atividade pode ser configurada com esquemas de solicitação e resposta usando esquemas personalizados fornecidos pelo usuário ou esquemas padrão inclusos no conector.

Juntos, uma conexão HTTP v2 específica e suas atividades são chamados de endpoint HTTP v2:

Tipos de atividade HTTP v2

  • PATCH: Aplica modificações parciais a um recurso existente em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • HEAD: Recupera a linha de status e a seção de cabeçalho de um recurso em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • POST: Cria um novo recurso em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • GET: Recupera informações sobre um recurso em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • OPTIONS: Recupera informações sobre as opções de comunicação para um recurso em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • BULK: Envia múltiplas solicitações para um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • DELETE: Exclui um recurso em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • PUT: Substitui um recurso existente em um serviço acessível por meio do protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Disable Auto Connector Update.

O conector HTTP v2 é usado para interagir com um serviço acessível por meio do protocolo HTTP ou HTTPS usando uma API REST, API GraphQL ou formulário web especificado pelo usuário. Os esquemas de solicitação e resposta do conector HTTP v2 são definidos a partir de esquemas personalizados fornecidos pelo usuário ou esquemas padrão incluídos no conector.

Solução de problemas

Se você tiver problemas com o conector HTTP v2, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Disable Auto Connector Update).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o log de depuração de operação (para agentes na nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.verbose.logging.http" level="DEBUG"/>

    Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.

  7. Para problemas e resoluções específicas do conector HTTP v2, consulte o guia Solução de problemas do conector:

Veja na prática