🇮🇹 IT

🌍 HTTP Request

Effettua qualsiasi richiesta HTTP verso un'API o un servizio esterno e restituisce la risposta. Supporta tutti i metodi HTTP comuni, header personalizzati, parametri di query e corpi di richiesta. Il nodo di integrazione piu flessibile per API di terze parti.

Categoria: Recupero ed Elaborazione Dati · Identificatore tipo: http_request

Panoramica

Il nodo HTTP Request e il blocco di integrazione universale in Flusso. Se un servizio espone un'API REST, un endpoint webhook o qualsiasi interfaccia HTTP, questo nodo puo comunicare con esso. Puoi recuperare dati da sistemi esterni, inviare dati a piattaforme di terze parti, attivare azioni remote o chiamare microservizi interni — tutto dall'interno di uno step del workflow.

Il nodo supporta valori dinamici nell'URL, negli header, nei parametri di query e nel corpo della richiesta usando riferimenti {{ variable }}. Questo rende semplice costruire richieste che incorporano dati da step precedenti del workflow, payload del trigger o input forniti dall'utente.

Il corpo della risposta viene automaticamente analizzato come JSON quando il Content-Type e application/json. Se la risposta e testo semplice o un altro formato, viene restituita la stringa grezza. Il campo ok offre un rapido controllo booleano per il successo senza dover ispezionare manualmente il codice di stato.

Configurazione

Campo	Stato	Descrizione
Method	Obbligatorio	Metodo HTTP — GET, POST, PUT, PATCH, DELETE, HEAD.
URL	Obbligatorio	URL completo incluso il protocollo, ad es. `https://api.example.com/v1/users`. Supporta riferimenti `{{ variable }}` per URL dinamici.
Headers	Opzionale	Coppie chiave-valore di header HTTP, ad es. `Authorization: Bearer {{ trigger.output.token }}`.
Query Parameters	Opzionale	Coppie chiave-valore aggiunte all'URL come parametri di query string.
Body	Opzionale	Corpo della richiesta. Per API JSON, inserisci un oggetto JSON. Supporta riferimenti `{{ variable }}`.
Content Type	Opzionale	Scorciatoia per l'header Content-Type. Predefinito: `application/json` quando e presente un corpo.
Timeout	Opzionale	Timeout della richiesta in secondi. Predefinito: 30.
Follow Redirects	Opzionale	Attiva/disattiva. Predefinito: attivato.

Dati di Output

Il nodo restituisce la risposta HTTP completa, inclusi codice di stato, corpo analizzato e header di risposta.

Campo	Tipo	Descrizione
`status`	number	Codice di stato della risposta HTTP (ad es. 200, 404)
`body`	object/string	Corpo della risposta JSON analizzato, o stringa grezza se la risposta non e JSON
`headers`	object	Header di risposta come coppie chiave-valore
`ok`	boolean	True se il codice di stato e 2xx

{{ http_step.output.status }} {{ http_step.output.body }} {{ http_step.output.body.id }} {{ http_step.output.headers.content-type }} {{ http_step.output.ok }}

Esempio di Utilizzo

Webhook trigger → HTTP Request per recuperare i dettagli dell'ordine dall'API Shopify → l'Agent elabora i dati.

Aggiungi un nodo Webhook Trigger. Quando viene effettuato un nuovo ordine, Shopify invia l'ID dell'ordine a questo webhook. Usa la chiave step webhook.
Aggiungi un nodo HTTP Request. Imposta Method su GET, URL su https://your-store.myshopify.com/admin/api/2024-01/orders/{{ webhook.output.order_id }}.json, e aggiungi un header X-Shopify-Access-Token. Usa la chiave step shopify_order.
Aggiungi un nodo Agent. Passa {{ shopify_order.output.body.order }} come contesto e istruisci l'agent a verificare eventuali problemi di evasione dell'ordine.
Aggiungi un nodo Conditional per ramificare: se l'agent segnala un problema, invia un messaggio Slack; altrimenti, non fare nulla.

Suggerimenti e Note

Memorizza le chiavi API in Impostazioni → Integrazioni, non direttamente nel nodo. Fai riferimento ad esse tramite una variabile di credenziale anziche codificare i token direttamente negli header o URL.
Controlla ok prima di usare body. Aggiungi un nodo Conditional dopo HTTP Request che verifichi {{ http_step.output.ok }} per gestire gli errori in modo appropriato anziche passare una risposta fallita agli step successivi.
Usa il campo body per l'accesso a JSON annidato. Se la risposta e un oggetto JSON, puoi accedere ai campi annidati direttamente: {{ http_step.output.body.data.users[0].email }}.
Imposta un timeout realistico. Il timeout predefinito di 30 secondi e generoso per la maggior parte delle API. Per endpoint lenti, aumentalo; per workflow sensibili alla latenza, diminuiscilo in modo che una richiesta in sospeso non blocchi l'intera esecuzione.
Le richieste GET non dovrebbero avere un corpo. Alcune API rifiutano le richieste GET con un corpo. Usa i Query Parameters per passare dati nelle richieste GET.

Nodi Correlati

Webhook Trigger — riceve chiamate HTTP in entrata per avviare un workflow.
Web Search — cerca nel web pubblico senza gestire chiavi API.
Set Variable — trasforma o riorganizza i dati della risposta HTTP prima di passarli ai nodi successivi.
Loop — itera su un array restituito nel corpo della risposta HTTP.