Agility Solution / Agility Studio / Herramientas de Agility Studio / 21.Http Request Assistant.
Actualizado: 24. June 2025

21.HTTP Request Assistant.

Herramienta integrada que permite construir, enviar y analizar solicitudes HTTP con acciones estandar(Get,Post,Put,Patch yDelete) y personalizadas, incluyendo headers y body.

2025-06-24_15h21_24.png

Boton Send:

Ejecuta la petición HTTP con los parámetros definidos en el asistente y retorna el resultado en la parte inferior, así el usuario podrá verificar si la petición está bien construida sin necesidad de lanzar toda la automatización.

2025-06-24_15h25_52.png

Boton Add:

Muestra en la parte inferior del asistente como quedaría configurado el process step HttpRequest, antes de ser incluido en el flujo del bot, al cerrar el asistente , se creara el process step en el nodo donde este posicionado.

2025-06-24_15h26_45.png

HTTP Verbs

2025-06-24_15h21_41.png

Un HTTP verb (o verbo HTTP) es un tipo de instrucción que se usa en el protocolo HTTP para indicar la acción que debe realizarse sobre un recurso en un servidor web.

🛠 Ejemplos de verbos HTTP y su propósito:

Verbo Acción que representa
GET Obtener un recurso (solo lectura)
POST Enviar o crear un nuevo recurso
PUT Reemplazar completamente un recurso
PATCH Actualizar parcialmente un recurso
DELETE Eliminar un recurso
HEAD Consultar headers de una peticion, no require body, no devuelve contenido, no modifica datos en el servidor
OPTIONS Preguntar al servidor qué operaciones o métodos están permitidos sobre un recurso, no require body, no devuelve contenido, no modifica datos en el servidor

Este campo solo permite seleccionar verbos de la lista.

HTTP Headers

2025-06-24_15h22_11.png

Un header HTTP (o encabezado HTTP) es una parte clave de una solicitud o respuesta HTTP que contiene metadatos: información adicional que describe la petición, la respuesta, o el propio contenido.

¿Qué es un HTTP Header?
Es un par clave-valor que se incluye en una petición o respuesta HTTP para transmitir información como:

  • El tipo de contenido que se envía o espera
  • El tipo de autenticación
  • Lenguaje preferido
  • Control de caché
  • Entre muchos otros

Ejemplos de headers comunes en una petición:

Header Propósito
Content-Type: application/json Indica que el cuerpo de la solicitud está en formato JSON
Authorization: Bearer 'token' Proporciona credenciales de autenticación
Accept: application/json Indica el tipo de respuesta que el cliente espera
User-Agent: Chrome/114 Describe el navegador o cliente que hace la petición

Este campo permite además de seleccionar headers de la lista, diligenciar headers customs.

HTTP Body

2025-06-24_15h25_01.png

En HTTP, el body (o cuerpo del mensaje) es la parte de la solicitud o respuesta que contiene los datos reales que se están enviando o recibiendo, como texto, JSON, archivos, etc.

El body es un bloque de datos que:

  • Sólo está presente en ciertos verbos como POST, PUT, PATCH (generalmente no en GET o DELETE)
  • Contiene la carga útil (payload): lo que realmente se quiere enviar (por ejemplo, un formulario, un JSON, un archivo...)

Este asistente es capaz de manejar peticion con body de tipo:

  • form-data: Usado para enviar archivos y formularios con múltiples partes, pemrite Archivos + texto.
  • raw: JSON estructurado clave:valor , muy común en APIs
  • x-www-form-urlencoded: Clave-valor tipo formulario web ej: name=Carlos&age=30

HTTP Query Params

2025-06-24_15h23_49.png

Los parámetros query (o query parameters) son una forma de enviar información adicional en una solicitud HTTP, específicamente en la URL. Se utilizan comúnmente en peticiones GET para filtrar, ordenar o modificar la respuesta del servidor.

Se pueden agregar mediante el formulario, estableciendo un nombre o key y su respectivo valor o value, automaticamente se iran colocando al final de la URL, después del signo ? y separados por & si hay más de uno.

¿Para qué se usan?: Sirven para:

  • Filtrar datos (ej: ?categoria=tecnologia)
  • Paginación (ej: ?pagina=2&limite=20)
  • Ordenar resultados (ej: ?orden=desc)
  • Buscar por palabras clave (ej: ?q=chatgpt)
  • Definir campos opcionales o configuraciones