Ir al contenido principal

Acción de solicitud HTTP

Send an HTTP request to an external endpoint as part of an automation pipeline.

Introducción

Envía una solicitud HTTP a cualquier punto de conexión durante una ejecución de automatización. Usa esta acción para integrar las automatizaciones de Level con sistemas externos: activa webhooks, publica datos en una API o llama a cualquier punto de conexión HTTP como parte de un flujo de trabajo.


Acción de solicitud HTTP

Si el lienzo aún no tiene acciones, selecciona Agregar una acción. Para agregar este paso a un lienzo que ya tiene acciones, haz clic en el botón en línea + donde quieras colocarla y selecciona Agregar otra acción. Luego elige Solicitud HTTP desde Otro categoría.

HTTP Request Action

URL

El punto de conexión al que se enviará la solicitud. Obligatorio. Haz clic en (x) para insertar una variable, variable del sistema o referencia de campo personalizado.

Método

El método HTTP de la solicitud.

Métodos admitidos: GET, POST, PUT, DELETE, PATCH.

Tipo de contenido

El tipo de contenido del cuerpo de la solicitud.

Opción

Uso

application/json

Cargas útiles JSON

text/plain

Texto sin formato

application/x-www-form-urlencoded

Envíos de formularios

Cuerpo

El cuerpo de la solicitud. Haz clic en (x) para insertar referencias a variables e incluir datos dinámicos del flujo de procesamiento.

Encabezados

Haz clic en + Agregar encabezados de solicitud para agregar pares de encabezado clave-valor personalizados. Haz clic en (x) en cualquiera de los campos para insertar una referencia a variable. Haz clic en × para eliminar una fila de encabezado.

Encabezados comunes:

  • Authorization: Bearer {{api_token}}

  • X-API-Key: {{api_key}}


Condiciones

La sección Condiciones te permite restringir cuándo se ejecuta esta acción según los atributos del dispositivo o el resultado de una acción anterior.

Consulta Condiciones de acción para la referencia completa sobre tipos de condiciones, operadores y valores.


Opciones adicionales

Expande Opciones adicionales para el nombre de la acción, el comportamiento ante fallos, la asignación de variables de salida, los reintentos y el interruptor de habilitación.

💡 CONSEJO: Usa Asignar salida de acción a variable en Opciones adicionales para capturar el cuerpo de la respuesta HTTP en una variable de automatización. Esto permite que las acciones posteriores actúen sobre la respuesta; por ejemplo, verificar un campo de estado devuelto por una API.

Consulta Descripción general de acciones para la referencia completa sobre las opciones adicionales disponibles en cada acción.


Preguntas frecuentes

  • ¿Qué se considera una solicitud exitosa? Una solicitud se considera exitosa cuando el punto de conexión devuelve un código de respuesta HTTP 2xx. Cualquier respuesta no 2xx (4xx o 5xx) se considera un error y la acción se marcará como fallida.

  • ¿Puedo enviar JSON en el cuerpo? Sí: establece Content-Type: application/json en la sección Encabezados y escribe tu carga útil JSON en el campo Cuerpo.

  • ¿Puedo autenticarme en un punto de conexión protegido? Sí: incluye un encabezado Authorization con tu token o credenciales. Usa (x) para hacer referencia a una variable de automatización almacenada o a un campo personalizado en lugar de codificar el valor de forma fija.

  • ¿Quién puede agregar o modificar acciones de solicitud HTTP? Técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulta Espacio de trabajo → Permisos para la configuración del control de acceso.

¿Ha quedado contestada tu pregunta?