Actividad de solicitud HTTP

Información general

La actividad Solicitud HTTP te permite realizar solicitudes HTTP a una API especificada utilizando la configuración del conector y conexión existente.

¿Por qué elegir la solicitud HTTP sobre otras actividades para un conector determinado?

Con la solicitud HTTP, puedes realizar solicitudes a cualquier punto final de la API de un proveedor, accediendo a sus capacidades completas. Esto significa que ahora puedes ir más allá de las funcionalidades de las actividades predefinidas ofrecidas por un conector de Integration Service.

Nota: la actividad Solicitud HTTP ahora está disponible solo para una parte de los conectores de Integration Service. Pronto se expandirá a cada conector que admita JSON. Consulta las notas de la versión del paquete de actividades individuales para aprender cuando la actividad está habilitada para un conector específico. También está disponible de forma predeterminada para cualquier conector personalizado creado con Creador de conectores.

Limitaciones

• Los conectores creados en API SOAP o SDK no admiten esta actividad.
• Las acciones de descarga o carga de archivos no son compatibles actualmente.
• Esta actividad actualmente solo abarca application/json para el tipo de contenido.

Compatibilidad de proyectos

Las actividades de solicitud HTTP están disponibles en Studio Web y en proyectos de Studio Desktop Windows y Multiplataforma.

Configuración

• ID de conexión: la conexión establecida en Integration Service. Accede al menú desplegable para elegir, añadir o gestionar las conexiones. Esta conexión es la misma que para cualquier otra actividad en este conector
• Método: el método de solicitud que se utilizará al llamar a la API. Se admiten los siguientes verbos HTTP:
  • GET : método utilizado para solicitar datos de un recurso especificado.
  • DELETE : método utilizado para eliminar datos de un recurso especificado.
  • PATCH : método utilizado para aplicar modificaciones parciales a un recurso.
  • POST : método utilizado para enviar datos al servidor.
  • PUT : método utilizado para enviar datos al servidor para actualizar un recurso.
• URL base: indica la URL base para la solicitud. Esto es de solo lectura y proporcionado por el conector. Si tu punto final requiere una URL/ruta base diferente, es probable que sea una solicitud de cambio o una solicitud HTTP personalizada a través del paquete de actividades web.
• Punto final: indica la ruta del punto final para la solicitud. Este campo se concatenará al campo URL base de solo lectura.
• Encabezados: los encabezados de la solicitud. Utiliza el editor de diccionario para añadir encabezados. Los encabezados predeterminados enviados por el conector al proveedor ya se muestran en el cuadro de información. Este campo de diccionario de encabezado te permite añadir encabezados adicionales.
• Parámetros de consulta: los parámetros de consulta. Utiliza el editor de diccionario para añadir nuevos parámetros.
  • Ejemplo: query value "select * from Vendor" (para QuickBooks Online).
• Cuerpo: introduce una carga útil JSON que se envía al punto final proporcionado.

Propiedades adicionales

Salida

• Contenido de la respuesta: la respuesta recibida de la solicitud HTTP. Este es un JSON y puede deserializarse.
• Estado derespuesta : el código de estado recibido de la solicitud HTTP, como variable de enteros.
• Encabezados derespuesta : la respuesta recibida de la solicitud HTTP.