Ir para o conteúdo

Conector HTTP v2

Resumo

O conector HTTP v2 estabelece acesso pelo 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 usada para gerar instâncias de atividades HTTP v2. Essas atividades, uma vez configuradas, interagem com um serviço acessível pelo protocolo HTTP ou HTTPS por meio da conexão.

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

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

Importante

Com o lançamento do conector HTTP v2, recomendamos converter as conexões e atividades HTTP existentes para HTTP v2. Saiba mais sobre os benefícios do conector HTTP v2 em nossa postagem do blog HTTP v2 ou veja 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 útil da Jitterbit. No momento, não há um cronograma para descontinuação e o conector HTTP continua com suporte total. Recomendamos que você converta as 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 uma origem ou um destino depende se o serviço da 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 chamadas de 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 origem ou destino em uma operação.

  • CABEÇA: 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 uma origem ou destino em uma operação.

  • PUBLICAR: Cria um novo recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

  • PEGAR: Recupera informações sobre um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

  • OPÇÕES: 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 origem ou destino em uma operação.

  • VOLUME: Envia várias solicitações para um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

  • APAGAR: Exclui um recurso em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

  • COLOCAR: Substitui um recurso existente em um serviço acessível pelo protocolo HTTP ou HTTPS e pode ser usado como origem ou destino em uma operação.

Nota

Este conector é um Connector SDK, que pode ser referenciado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

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 pelo protocolo HTTP ou HTTPS usando uma REST API, GraphQL API ou formulário da 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 com o conector.

Solução de problemas

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

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

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

  3. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode habilitar conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

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

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

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