Ir para o conteúdo

Conector HTTP v2 no Jitterbit Studio

Resumo

O conector HTTP v2 estabelece acesso através do protocolo HTTP ou HTTPS a um serviço como uma API REST, API GraphQL ou formulário da web.

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

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

Para outras maneiras de se conectar a um serviço web RESTful e uma comparação com o conector HTTP, veja 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 post no blog sobre HTTP v2 ou veja uma comparação de 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á um cronograma para descontinuação e o conector HTTP continua totalmente suportado. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 sempre que possível.

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão HTTP v2. Os tipos de atividades 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 alvos (para consumir dados em uma operação).

Se uma instância de atividade pode ser usada como fonte ou destino depende de se o serviço web requer uma solicitação estruturada ou retorna 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 incluídos com o conector.

Juntas, uma conexão HTTP v2 específica e suas atividades são referidas como um endpoint HTTP v2:

Tipos de atividade HTTP v2

  • PATCH: Aplica modificações parciais a um recurso existente em um serviço acessível pelo 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 pelo 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 pelo 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 pelo 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 pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

  • BULK: Envia várias solicitações a um serviço acessível pelo 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 pelo 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 pelo protocolo HTTP ou HTTPS e pode ser usado como fonte ou destino em uma operação.

Nota

Este conector é um conector baseado no Connector SDK, que pode ser referenciado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

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

O conector HTTP v2 requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector HTTP v2 é usado para interagir com um serviço acessível através do protocolo HTTP ou HTTPS usando uma API REST especificada pelo usuário, API GraphQL ou formulário da web. 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 com o conector.

Solução de problemas

Se você encontrar problemas com o conector HTTP v2, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desativar Atualização Automática do Conector).

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

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

  4. Se estiver usando agentes privados, você pode ativar o registro 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 o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados do Jitterbit.

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

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

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

Veja na prática