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 endpoint durante la ejecución de una automatización. Utiliza esta acción para integrar las automatizaciones de Level con sistemas externos: activa webhooks, publica datos en una API o llama a cualquier endpoint HTTP como parte de un flujo de trabajo.


Acción de solicitud HTTP

Desde el pipeline de automatización en modo de edición, haz clic en + y selecciona solicitud HTTP de la categoría Otros.

HTTP Request Action

URL

El endpoint 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 para 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 de variables e incluir datos dinámicos del pipeline.

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 de 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 en función de los atributos del dispositivo o del resultado de una acción anterior.

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


Opciones adicionales

Expande Opciones adicionales para el nombre de la acción, el comportamiento ante errores, 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 endpoint 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 endpoint 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 directamente.

  • ¿Quién puede agregar o modificar acciones de solicitud HTTP? Los 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?