Solicitud HTTP
Usa esta acción cuando necesites llamar a una API o webhook externo desde un workflow o acción de agente.
Mejor para
- Enviar datos a sistemas externos
- Obtener información antes de que pasos posteriores continúen
- Obtener cargas útiles pequeñas (las respuestas están limitadas a 5 MB — para descargas más grandes a almacenamiento usa la acción Descargar a Almacenamiento,
actions/network/http/download-to-storage, que transmite archivos de hasta 500 MB)
Campos principales
| Campo | Qué hace |
|---|---|
| Método HTTP | Elige el método HTTP, como GET o POST |
| URL HTTP | El endpoint objetivo |
| Propósito | Etiqueta opcional de lo que hace la solicitud, mostrada en los logs |
| Encabezados HTTP | Agrega headers de solicitud personalizados |
| Cuerpo de la solicitud HTTP | Envía datos para métodos como POST o PATCH (oculto para GET) |
| Retornar como buffer | Retorna datos crudos del archivo en vez de texto o JSON |
| Habilitar caché | Reutiliza respuestas idénticas (mismo método, URL, headers y cuerpo). El caché se comparte entre ejecuciones separadas para la misma empresa + asistente, y las entradas viven alrededor de 10 minutos — una solicitud idéntica en una ejecución posterior puede devolver una respuesta en caché |
Restricciones de URL
Solo se permiten URLs públicas http:// y https://. Las solicitudes a localhost, a direcciones de red privadas o internas y a endpoints de metadatos de la nube están bloqueadas, por lo que la acción no puede alcanzar servicios en una intranet o VPN. Las solicitudes expiran después de 2 minutos.
Qué pueden usar los pasos posteriores
Los resultados de la solicitud están disponibles en:
step(N).statusstep(N).datastep(N).headers
Consejos
- Almacena claves de API y otros valores sensibles de header como secretos en vez de texto plano.
- Usa el modo buffer cuando la respuesta sea un archivo, imagen o PDF pequeño (hasta 5 MB); para descargas más grandes a almacenamiento usa la acción Descargar a Almacenamiento (
actions/network/http/download-to-storage, hasta 500 MB). - Verifica el código de estado antes de asumir que la solicitud fue exitosa.