Saltar al contenido

Conector HTTP v2 en Jitterbit Studio

Resumen

El conector HTTP v2 establece acceso a través del protocolo HTTP o HTTPS a un servicio como una API REST, API GraphQL o formulario web.

El conector HTTP v2 proporciona una interfaz para crear una conexión HTTP v2, la base utilizada para generar instancias de actividades HTTP v2. Estas actividades, una vez configuradas, interactúan con un servicio accesible a través del protocolo HTTP o HTTPS mediante la conexión.

Se accede al conector HTTP v2 desde la pestaña Extremos de proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Para otras formas de conectarse a un servicio web RESTful y una comparación con el conector HTTP, consulta Consideraciones sobre conectores basados en REST.

Importante

Con el lanzamiento del conector HTTP v2, recomendamos convertir las conexiones y actividades HTTP existentes a HTTP v2. Obtén más información sobre los beneficios del conector HTTP v2 en nuestro artículo de blog sobre HTTP v2 o consulta una comparación de las características del conector HTTP y HTTP v2.

La intención a largo plazo de Jitterbit es deprecar el conector HTTP, lo que se anunciará de conformidad con la política de fin de vida de Jitterbit. Actualmente, no hay un cronograma para la deprecación y el conector HTTP sigue siendo totalmente compatible. Recomendamos que conviertas las conexiones y actividades HTTP existentes a HTTP v2 cuando sea posible.

Descripción general del conector

Este conector se utiliza para configurar primero una conexión HTTP v2. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que pueden usarse como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

La posibilidad de usar una instancia de actividad como origen o destino depende de si el servicio web requiere una solicitud estructurada o devuelve una respuesta estructurada. Cada instancia de actividad puede configurarse con esquemas de solicitud y respuesta utilizando esquemas personalizados proporcionados por el usuario o esquemas predeterminados incluidos con el conector.

En conjunto, una conexión HTTP v2 específica y sus actividades se denominan extremo HTTP v2:

Tipos de actividad HTTP v2

  • PATCH: Aplica modificaciones parciales a un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • HEAD: Recupera la línea de estado y la sección de encabezado de un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • POST: Crea un nuevo recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • GET: Recupera información sobre un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • OPTIONS: Recupera información sobre las opciones de comunicación para un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • BULK: Envía múltiples solicitudes a un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • DELETE: Elimina un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • PUT: Reemplaza un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

Los extremos creados con este conector se incluyen en reportes de uso de extremos y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede usar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

El conector HTTP v2 se utiliza para interactuar con un servicio accesible a través del protocolo HTTP o HTTPS usando una API REST, API GraphQL o formulario web especificado por el usuario. Los esquemas de solicitud y respuesta del conector HTTP v2 se definen a partir de esquemas personalizados proporcionados por el usuario o esquemas predeterminados incluidos con el conector.

Solución de problemas

Si experimentas problemas con el conector HTTP v2, se recomiendan estos pasos para la solución de problemas:

  1. Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para asegurar que la versión más reciente del conector se descargue en el agente (a menos que uses la política de organización Disable Auto Connector Update).

  2. Revisa los registros de operación para cualquier información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:

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

    Para más información sobre el registro detallado del conector, consulta Registro detallado para conectores usando agentes privados de Jitterbit.

  5. Si usas agentes privados, puedes revisar los registros del agente para más información.

  6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.

  7. Para problemas y resoluciones específicos del conector HTTP v2, consulta la guía Solución de problemas del conector:

Verlo en la práctica