Nodo HTTP Request
El nodo HTTP Request hace peticiones a cualquier API externa. Es el comodín para integrar servicios que no tienen un nodo dedicado.
Parámetros
Sección titulada «Parámetros»| Campo | Por defecto | Descripción |
|---|---|---|
| Método | GET | GET · POST · PUT · PATCH · DELETE · HEAD · OPTIONS |
| URL | — | Destino (admite {{variables}}) |
| Parámetros de query | — | Pares clave/valor añadidos a la URL |
| Headers | — | Cabeceras de la petición |
| Cuerpo (body) | — | JSON, XML o texto (no aplica a GET/HEAD) |
| Tipo de body | json | json · xml · text |
| Timeout | 30000 ms | Tiempo máximo de espera |
| Seguir redirecciones | Sí | Hasta 5 redirecciones |
Autenticación
Sección titulada «Autenticación»| Tipo | Campos |
|---|---|
| Ninguna | — |
| Bearer | Token |
| API Key | Nombre del header (por defecto X-API-Key) + valor |
| Basic | Usuario + contraseña |
Manejo de respuesta por código
Sección titulada «Manejo de respuesta por código»Defines qué hacer según el rango del status: continuar o error. Por defecto: 2xx → continuar, 4xx → error, 5xx → error.
Salidas
Sección titulada «Salidas»| Campo | Descripción |
|---|---|
status | Código HTTP |
statusText | Texto del estado |
headers | Cabeceras de la respuesta |
body | Cuerpo de la respuesta (JSON parseado si aplica) |
ok | true si el código fue 2xx |
Límite: el tamaño máximo de respuesta es 25 MB.
Ejemplo
Sección titulada «Ejemplo»Consultar una API con Bearer y usar el resultado:
- Método:
GET - URL:
https://api.ejemplo.com/clientes/{{triggerData.clienteId}} - Autenticación: Bearer, token
{{secrets.API_EJEMPLO}}
Luego lees {{nodes.http_request.body.nombre}}.
Problemas comunes
Sección titulada «Problemas comunes»- 401/403 — revisa la autenticación y que el token/secret sea válido.
- El body no llega — verifica el Tipo de body y que el método no sea GET/HEAD.
- Respuesta muy grande — supera el límite de 25 MB; pide menos datos o pagina.