Http

La actividad HTTP te permite realizar solicitudes de API basadas en JSON dentro de tu flujo de trabajo. 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.

Limitaciones conocidas

• No admite conexiones configuradas a través de Integration Service. Para utilizar la autenticación o las conexiones existentes desde un conector, utiliza la actividad Conector y selecciona la actividad Solicitud HTTP desde ese conector.
• Solo admite solicitudes y respuestas basadas en JSON. Asegúrate de que tus solicitudes incluyan encabezados, como Content-Type: application/json y Accept: application/json.

Utilizar la actividad HTTP

Para añadir una actividad 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:
   • Método : especifica el método HTTP para la solicitud, como GET, POST, PATCH, DELETE o PUT.
   • URL de solicitud : define 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.
   • Encabezados : define 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**********"
     }

   • Cuerpo de la solicitud : disponible para todos los métodos HTTP excepto GET 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. Pruebe 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 de configuración Depurar , luego pega y guarda la siguiente sintaxis JSON:

{
  "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 | tostring)

   • 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. Prueba el flujo de trabajo para ejecutar la actividad.
5. Consulta el panel Salida para revisar la respuesta HTTP.