Nœud HTTP Request n8nConfigurer HTTP Request dans n8n.

Le sélecteur du haut fixe le verbe envoyé sur le réseau, et le reste du panneau s'adapte. Une lecture prend GET, une écriture POST ou PUT, une mise à jour partielle PATCH.

• Method : sept choix, DELETE, GET, HEAD, OPTIONS, PATCH, POST et PUT, selon ce que demande la documentation de l'API.

L'endpoint saisi ici est l'adresse où atterrit l'appel, et c'est le seul champ sans lequel le nœud refuse de démarrer. Les expressions y ont leur place, ce qui permet de changer de chemin à chaque item.

• URL : l'endpoint complet, du genre http://example.com/index.html, souvent construit depuis le nœud précédent avec {{ $json.id }} dans le chemin.

Trois façons de prouver qui appelle tiennent dans ce sélecteur, et le choix commande le champ qui apparaît juste en dessous.

• None (none) : rien n'est joint à la requête.
• Predefined Credential Type (predefinedCredentialType) : l'authentification déjà implémentée par n8n, choisie dans Credential Type, recommandée quand le service est disponible.
• Generic Credential Type (genericCredentialType) : entièrement paramétrable via Generic Auth Type, de Basic auth à OAuth2 API.

Certains serveurs attendent que l'appelant présente son propre certificat avant d'ouvrir la discussion. Ce commutateur sert à en fournir un.

• SSL Certificates : un simple interrupteur, laissé inactif tant que la cible n'exige pas de certificat client.

Les paramètres de requête servent de filtres sur l'appel. Active ce commutateur quand l'API les accepte et que la demande doit être resserrée.

• Specify Query Parameters : keypair (Using Fields Below) pour des paires nom et valeur ajoutées une à une, ou json (Using JSON).
• Query Parameters : les paires elles-mêmes, complétées avec Add Query Parameter.
• JSON : les mêmes filtres écrits en un seul objet.

Les en-têtes portent les métadonnées et le contexte de l'appel, ce que l'API lit avant de regarder quoi que ce soit d'autre. Ce commutateur ouvre les champs qui les contiennent.

• Specify Headers : keypair (Using Fields Below) pour des paires nom et valeur, ou json (Using JSON).
• Headers : les paires, ajoutées via Add Header.
• JSON : l'ensemble des en-têtes en un objet.

Créer ou modifier une donnée suppose d'envoyer du contenu avec l'appel. Active ce commutateur, puis choisis le format documenté par l'API.

• Body Content Type : json (JSON), form-urlencoded (Form Urlencoded), multipart-form-data (Form-Data), binaryData (n8n Binary File) ou raw (Raw).
• Specify Body : champs explicites (keypair) ou objet JavaScript (json), remplis par Body Parameters, JSON ou un Body unique au format field1=value1&field2=value2.
• Input Data Field Name : le champ entrant qui porte le fichier binaire, avec Content Type pour un corps brut.

Chaque item entrant devient une requête, ce qu'une API à quota remarque vite. Cette option les regroupe et respire entre les groupes.

• Items per Batch : le nombre d'items par lot, -1 désactive le découpage et 0 compte pour un.
• Batch Interval (ms) : la pause entre deux lots, 0 pour aucune. À 1000, le rythme tombe à une requête par seconde.

Par défaut, le nœud ne télécharge la réponse que si la validation du certificat aboutit. Ajouter cette option laisse passer la réponse même quand la validation échoue.

• Ignore SSL Issues (Insecure) : un interrupteur unique, inactif en usage normal, activé quand le certificat ne peut pas être vérifié.

Les API ne s'accordent pas sur l'écriture d'un filtre répété dans une URL, et cette option tranche, mais seulement une fois Send Query Parameters activé.

• No Brackets (repeat) : le nom se répète, foo=bar&foo=qux.
• Brackets Only (brackets) : des crochets après chaque nom, foo[]=bar&foo[]=qux.
• Brackets with Indices (indices) : crochets et position, foo[0]=bar&foo[1]=qux.

Les noms d'en-têtes sortent en minuscules sauf indication contraire. Activé correspond au comportement par défaut, désactivé conserve la casse exactement telle qu'elle a été saisie.

• Lowercase Headers : un interrupteur, utile seulement face à un service qui lit les noms d'en-têtes au pied de la lettre.

Quand un serveur renvoie vers une nouvelle adresse, le nœud suit par défaut. Cette option borne ce comportement ou l'arrête.

• Follow Redirects : activé par défaut, à désactiver pour lire la réponse de redirection elle-même plutôt que sa destination.
• Max Redirects : le plafond de sauts acceptés avant abandon.

Ce qui sort du nœud se négocie. Cette option en règle la forme, du format jusqu'à ce qui compte comme un échec.

• Include Response Headers and Status : renvoie la réponse complète au lieu du seul corps.
• Never Error : réussit même quand le code de statut n'est pas 2xx, et la gestion d'erreur repart dans le workflow.
• Response Format : autodetect (Autodetect), json (JSON), text (Text) ou file (File), les deux derniers écrivant dans Put Output in Field.

Les grandes collections arrivent en tranches, et cette option redemande jusqu'à ce que tout soit là. Regarde d'abord une réponse sans pagination pour repérer la mécanique de l'API.

• Pagination Mode : off (Off), updateAParameterInEachRequest (Update a Parameter in Each Request) avec ses Parameters, ou responseContainsNextURL (Response Contains Next URL) avec Next URL.
• Pagination Complete When : Response Is Empty, Receive Specific Status Code(s) avec Status Code(s) when Complete, ou Other avec Complete Expression.
• Limit Pages Fetched et Max Pages, plus Interval Between Requests (ms).

Le trafic sortant doit parfois emprunter une passerelle précise, pour du filtrage ou pour garder une adresse de sortie fixe. Un seul champ s'en charge.

• Proxy : le proxy HTTP utilisé par la requête, écrit comme http://myproxy:3128, prioritaire sur les variables d'environnement globales HTTP_PROXY, HTTPS_PROXY et ALL_PROXY.

Un serveur qui ne répond jamais est pire qu'un serveur qui refuse. Cette valeur plafonne l'attente des en-têtes de réponse et du début du corps avant abandon.

• Timeout : l'attente en millisecondes, par exemple 5000 sur un endpoint censé répondre tout de suite.

Une redirection peut mener ailleurs, sur un tout autre domaine. Cette option décide si les secrets font le voyage.

• Send Credentials on Cross-Origin Redirect : un commutateur qui autorise les credentials, dont l'en-tête Authorization, à suivre une redirection vers une origine différente.

Branché sur un agent IA comme outil, le nœud donne sa réponse à un modèle, et une réponse d'API brute gaspille des jetons. Cette option la dégraisse avant lecture.

• Expected Response Type : json (JSON) avec Field Containing Data, Include Fields (All, Selected, Except) et Fields ; html (HTML) avec Selector (CSS), Return Only Content et Elements To Omit ; ou text (Text).
• Truncate Response et Max Response Characters : un plafond ferme sur la taille.