Http

La actividad de solicitud HTTP te permite realizar solicitudes de API basadas en JSON dentro de tu flujo de trabajo. Puedes utilizar el conector HTTP genérico o cualquiera de los conectores de Integration Service compatibles para la autenticación, pero también tienes la opción de utilizar la actividad sin conexión y proporcionar los detalles de autenticación directamente en la solicitud.

La actividad proporciona un control total sobre la configuración de la solicitud, lo que permite la definición dinámica de métodos, URL, encabezados y contenido del cuerpo. Después de la ejecución, los datos de respuesta quedan disponibles como referencia en los pasos posteriores del flujo de trabajo, lo que los convierte en un componente crítico para interactuar con las API externas.

Nota:

Puedes aprovechar Autopilot para añadir la solicitud HTTP por ti pegando la cURL deseada en el chat.

Utilizar la actividad HTTP

Para añadir una actividad de solicitud HTTP a tu flujo de trabajo:

1. En el lienzo del diseñador de flujo de trabajo de la API, selecciona el icono más (+). Aparecerá el menú Añadir actividad .
2. Selecciona HTTP.
3. En el panel Propiedades , configura los siguientes campos:
   • Autenticación : el tipo de autenticación que se utilizará, ya sea autenticación manual o autenticación basada en conector.
   • Conector : si seleccionaste Autenticación basada en conector, selecciona el conector a utilizar.
   • Conexión : la conexión establecida en Integration Service. Selecciona una conexión existente, haz clic en + Conexión para añadir una nueva conexión o haz clic en Abrir conexiones para gestionar las conexiones.
   • Método : el método HTTP para la solicitud, GET, POST, PATCH, DELETE, PUT, OPTIONS o HEAD.
   • URL de solicitud : el punto final de la API para la solicitud. Puedes crear URL de forma dinámica utilizando el editor de expresiones. Por ejemplo, anexar un ID recuperado de un paso de flujo de trabajo anterior. Si se establece una URL base, introduce una ruta relativa. Para anularlo, utiliza una URL absoluta con el mismo dominio base.
   • Encabezados : los encabezados de la solicitud como pares clave-valor. Los encabezados utilizan un formato de objeto JSON y pueden generarse dinámicamente con el editor de expresiones. Por ejemplo:

     {
       "Content-Type": "application/json",
       "Accept": "application/json",
       "Authorization": "Bearer jfio**********"
     }
     

   • 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 : disponible para todos los métodos HTTP excepto GET, OPTIONS y HEAD. Admite cargas útiles basadas en JSON, lo que te permite hacer referencia a datos de salidas de pasos anteriores utilizando el editor de expresiones.
4. Depura el flujo de trabajo para ejecutar la actividad y generar campos de salida para su uso posterior.

Ejemplo de actividad HTTP

El siguiente ejemplo realiza una solicitud POST a HTTPBin, que devuelve los datos de la solicitud para su validación. La solicitud incluye variables de ruta dinámicas, encabezados y un cuerpo de solicitud estructurado.

Abre la ventana Configuración de depuración , luego pega y guarda la siguiente sintaxis JSON en la sección Argumentos del proyecto :

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-24T10:30:00Z",
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. En el lienzo del diseñador de flujo de trabajo de la API, añade una actividad de Script para generar un valor de token de portador:

   1. Abre el editor de expresiones y devuelve un JSON con una propiedad llamada Bearer_token:

      return {
          "bearer_token": "123321123321"
      }
      

   2. Guardar.

2. Añade una actividad HTTP al lienzo del diseñador.

3. Configura la actividad HTTP de la siguiente manera:

   • Método : POST
   • Solicitar URL : utiliza el editor de expresiones para crear la cadena URL con una variable de ruta de ID :

     "https://www.httpbin.org/anything/" + ($workflow.input.id)
     

   • Encabezados : añade encabezados especificando un JSON clave-valor simple. También estás simulando el proceso para añadir un token al portador como encabezado de autorización:

     {
         "Accept": "application/json",
         "Content-Type": "application/json",
         "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
     }
     

   • Cuerpo de la solicitud : utiliza el editor de expresiones para crear dinámicamente el cuerpo de la solicitud haciendo referencia a tu JSON de configuración de ejecución. El objetivo es pasar una matriz de transacciones envueltas dentro de un objeto como carga útil de la solicitud:

     {
         "transactions": $workflow.input.transactions
     }
     

   Observa que el panel de salida Expresión muestra cómo debería ser el JSON final en función de los datos de entrada de la prueba de actividad :

   

4. Depura el flujo de trabajo para ejecutar la actividad.

5. Consulta el panel Salida para revisar la respuesta HTTP.