Roboteka
Roboteka · Robots · Solicitud HTTP GET/POST

Solicitud HTTP GET/POST

El robot «Solicitud HTTP GET/POST» envía una solicitud a una API externa desde un proceso de negocio. Acepta una URL, el método (GET, POST, PUT, PATCH, DELETE, HEAD), el cuerpo de la solicitud, cabeceras en JSON y el tiempo de espera, y devuelve el cuerpo de la respuesta, el código de estado HTTP y un indicador de éxito (Y/N). Funciona en los procesos de negocio y robots de Bitrix24 (Alaio).

El robot ejecuta una solicitud HTTP a una API externa directamente desde un proceso de negocio de Bitrix24 (Alaio) — sin código ni servicios intermedios. Admite los métodos GET, POST, PUT, PATCH, DELETE y HEAD, un cuerpo de solicitud arbitrario, cabeceras en JSON (p. ej. Authorization) y un tiempo de espera de 1 a 60 segundos. Casos típicos: enviar los datos de la negociación a un sistema de contabilidad externo o consultar el estado de un pedido en la API de un servicio de mensajería. Las redirecciones (hasta 5) se validan en cada salto, las solicitudes a direcciones internas de la red se bloquean y el cuerpo de la respuesta está limitado a 1 MB. Devuelve el cuerpo de la respuesta, el código de estado HTTP y el indicador de éxito (Y/N): analice la respuesta con el robot «Extraer valor de JSON por ruta» y construya una condición sobre el indicador en el diseñador de procesos. No se ejecuta mientras Bitrix24 está en modo de demostración.

¿Qué parámetros de entrada acepta el robot?

Parámetro Tipo ¿Obligatorio? Por defecto
URL string sí
Método HTTP (por defecto GET) select GET, POST, PUT, PATCH, DELETE, HEAD — GET
Cuerpo de la solicitud (para POST/PUT) string —
Cabeceras en JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Tiempo de espera en segundos (por defecto 10) int —

¿Qué devuelve el robot?

Parámetro Tipo
Cuerpo de la respuesta string
Código de estado HTTP int
Éxito (Y/N) — código 2xx string

¿Qué errores puede devolver el robot?

El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.

  • Error: el método debe ser uno de {methods}
  • Error: las cabeceras deben ser un objeto JSON
  • Error: nombre de cabecera no válido: {name}
  • Error: no se permiten caracteres de control en la cabecera {name}
  • Error: la cabecera {name} se establece automáticamente
  • Error de cURL: {error}
  • Este robot no se ejecuta mientras Bitrix24 está en modo de demostración o si no se pudo determinar el plan.

Escenario: consultar el estado de un pedido en un servicio externo

  1. Una negociación pasa a la etapa «Entrega» y activa el robot
  2. El robot envía una solicitud GET a la API del servicio de mensajería con el número del pedido
  3. El robot «Extraer valor de JSON» obtiene el estado de la respuesta
  4. El estado se escribe en un campo de la negociación y queda visible para el gestor

Robots similares

Artículos relacionados