Ir para o conteúdo

Conector HTTP V2

Resumo

O Harmony HTTP v2 Connector estabelece acesso por meio do protocolo HTTP ou HTTPS a um serviço como 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 Conexões 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, consulte Considerações sobre conectores baseados em REST.

Importante

Com o lançamento do conector HTTP v2, recomendamos a conversão de 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 do conector HTTP e HTTP v2.

A intenção de longo prazo da Jitterbit é descontinuar o conector HTTP, 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 compatível. Recomendamos que você converta conexões e atividades HTTP existentes para HTTP v2 quando possivel.

Visão Geral do Conector

Este conector é usado para configurar primeiro 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 origem ou destino depende 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 no conector.

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

Tipos de atividade HTTP v2

  • CORREÇÃO: 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 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 de 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.

  • EXCLUIR: 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 SDK do conector, que pode ser referido 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 do agente 10.1 ou mais tarde. Essas versões do 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 API REST, uma API GraphQL ou um 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 de esquemas padrão incluídos no 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 Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).

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

  3. Habilite o registro de depurar de operação (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 registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:

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

  5. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.