DocumentaciónWorkflowsApps y servicios
HTTP nodo
Llama a una URL externa, p. ej. una API, otro webhook o un servidor MCP. Auth, body, headers y parámetros de query pueden rellenarse con plantillas. El body de la respuesta se parsea automáticamente como JSON. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
10 min de lecturaActualizado el
Qué hace este nodo
Llama a una URL externa, p. ej. una API, otro webhook o un servidor MCP. Auth, body, headers y parámetros de query pueden rellenarse con plantillas. El body de la respuesta se parsea automáticamente como JSON.
Usa HTTP como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade HTTP desde el catálogo de nodos.
- 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 04Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
HTTP tiene una función concreta. Sus ajustes aparecen al seleccionar el nodo.
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Método | Opciones: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS | Estándar |
| URL | Configura este valor en el panel del nodo. | Estándar |
| Autenticación | Cómo se autentica la API externa. El token / key / contraseña va en su respectivo campo de abajo. | Estándar |
| Credenciales desde un secreto del workflow | Elige el secreto del workflow con el token, la clave de API o la contraseña de Basic Auth. El texto en claro nunca entra en el JSON del workflow. | Protegido |
| Nombre del campo de la clave | Cómo se llama el campo en el que la API espera tu clave. Suele estar en la documentación de la API, a menudo X-API-Key. | Estándar |
| Nombre del parámetro de la clave en la URL | Cómo se llama el parámetro de la URL que lleva tu clave, p. ej. ?api_key=… . Consta en la documentación de la API. | Estándar |
| Username | Configura este valor en el panel del nodo. | Estándar |
| Parámetros de query | Se añaden a la URL como ?key=value. Las query strings ya presentes en la URL se conservan. | Estándar |
| Headers | Pares clave/valor como campos. Authorization se establece automáticamente mediante el campo de auth de arriba, aquí solo headers personalizados. | Estándar |
| Formato del body | Cómo se transmite el body. 'Form' para APIs antiguas que esperan campos como datos de formulario; 'Bruto' para XML o texto plano. En caso de duda: Automático. | Estándar |
| Body | Editor no-code: añade campo + valor, el tipo (texto/número/booleano/JSON) se detecta automáticamente. Arriba a la derecha puedes cambiar a JSON en bruto. | Estándar |
| Leer respuesta como | JSON detiene el workflow si la respuesta no contiene datos estructurados válidos. | Estándar |
| Transmitir | Al recibir una lista, el siguiente paso puede procesar cada entrada por separado. | Estándar |
| Nombre del texto o archivo | El paso siguiente encuentra el texto o archivo con este nombre. Los datos JSON conservan sus propios nombres de campo. | Estándar |
| Contrato de importación | Configura este valor en el panel del nodo. | Estándar |
| Formato de los datos importados | Configura este valor en el panel del nodo. | Estándar |
| Seguir redirecciones | Solicita la nueva dirección cuando hay una redirección. Desactivado, el paso siguiente recibe la primera respuesta. | Estándar |
| Ante un error HTTP | „Continuar" deja que el workflow siga incluso con 4xx/5xx o errores de red, compruebas $json.ok y reaccionas (reintento, fallback, log). | Estándar |
| Cancelar tras (milisegundos) | Cancela la petición si la otra parte tarda demasiado. En milisegundos (1000 = 1 segundo). Máximo 30000 (30 segundos). | Estándar |
| Tamaño máximo de respuesta (bytes) | Las respuestas más grandes se cancelan para que el workflow no se sobrecargue. Indicado en bytes (5000000 = 5 MB). Predeterminado 5 MB, máximo 10 MB. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| url | URL de destino. Sobrescribe el campo de configuración. | text |
| body | Body de la petición. | json |
| Salida | Significado | Tipo |
|---|---|---|
| body | Configura este valor en el panel del nodo. | json |
| status | Código de estado HTTP. | number |
| ok | true si 2xx, false en caso contrario. | boolean |
| headers | Headers de la respuesta (keys en minúscula). | json |
Ejemplo y prueba
API-GET con Bearer-Token: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"query": "anymize",
"limit": 10
}Acceso y seguridad
Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.