Quelle est la difference entre GET et POST dans le noeud HTTP Request ?

GET sert a recuperer des donnees (lire une ressource), POST sert a envoyer des donnees (creer une ressource). GET n'a pas de body, les parametres passent dans l'URL. POST envoie les donnees dans le body de la requete. En pratique, ces deux methodes couvrent plus de 90 % des usages dans n8n.

Comment passer une cle d'API dans le noeud HTTP Request ?

Trois methodes : utiliser un Predefined Credential (connecteur preconfigure pour les services courants), creer un Generic Credential (OAuth2, Header Auth), ou passer la cle directement dans les headers ou query parameters. La methode la plus flexible est de mettre la cle dans les headers, par exemple 'Authorization: Bearer votre_cle'.

Comment envoyer du JSON dans le body ?

Activer 'Send Body', choisir 'Using JSON', puis basculer en mode 'Expression' (pas 'Fixed'). Entourer le JSON avec des doubles accolades {{ }} pour que n8n l'evalue comme du code JavaScript. Erreur courante : coller du JSON brut sans les doubles accolades, ce qui genere une erreur 'JSON is not valid'.

Comment gerer la pagination d'une API ?

Dans les options du noeud, activer 'Pagination'. Configurer la cle de page (ex: 'page') et utiliser la valeur retournee par l'API pour la page suivante (ex: response.next_page). n8n boucle automatiquement jusqu'a ce qu'il n'y ait plus de page suivante.

Que faire quand l'API ne repond pas ou retourne une erreur ?

Activer 'Retry on Fail' pour reessayer automatiquement (jusqu'a 5 fois, avec intervalle configurable). Configurer 'On Error' sur 'Continue' pour ne pas bloquer le workflow, ou sur 'Continue Using Error Output' pour router vers un chemin alternatif. Activer 'Always Output Data' pour garantir une sortie meme sans reponse.

Noeuds n8n

Comment utiliser le noeud HTTP Request dans n8n

Publié le 1 mars 202529min

Chapitres

Résumé

Le noeud HTTP Request est le noeud le plus polyvalent de n8n. Il permet de communiquer avec n'importe quelle API REST : recuperer des donnees (GET), envoyer des informations (POST), mettre a jour des ressources (PUT/PATCH) ou les supprimer (DELETE). Ce guide couvre la configuration complete du noeud, des methodes HTTP a l'authentification, en passant par les headers, le body, la pagination et la gestion des erreurs. Deux exemples concrets illustrent la theorie : une API ouverte (JSONPlaceholder) et une API authentifiee (Haloscan, outil SEO).

Points cles

7 methodes HTTP supportees : GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
3 modes d'authentification : Predefined Credential, Generic Credential, ou via headers/query parameters
Body au format JSON (mode expression avec doubles accolades) ou via champs individuels
Gestion des erreurs : retry on fail, continue on error, always output data
Options avancees : pagination automatique, proxy, timeout, batching, redirect
Present dans la quasi-totalite des workflows en production

Methodes HTTP : quand utiliser laquelle

Chaque methode HTTP a un role specifique, meme si toutes les API ne respectent pas strictement ces conventions :

GET : recuperer des donnees. Lire, consulter une ressource. La plus utilisee
POST : envoyer des donnees. Creer une ressource, soumettre un formulaire
PUT : remplacer entierement une ressource existante. Mise a jour complete
PATCH : mettre a jour partiellement une ressource. Modifier un seul champ
DELETE : supprimer une ressource
HEAD : recuperer uniquement les en-tetes, sans le corps de la reponse
OPTIONS : verifier les methodes autorisees sur une ressource (CORS)

En pratique, GET et POST representent plus de 90 % des appels dans un workflow n8n.

Configurer une requete : URL, headers et body

La configuration suit trois etapes : definir la methode et l'URL, ajouter les headers si requis par l'API, et renseigner le body pour les methodes POST/PUT/PATCH. Les headers courants sont Content-Type: application/json et Accept: application/json. Pour le body, deux modes sont disponibles : "Using Fields Below" (champs nom/valeur) ou "Using JSON" (objet JSON complet). En mode JSON avec des expressions n8n, utiliser les doubles accolades {{ }} pour executer du code JavaScript.

Authentification et cles d'API

Trois approches existent pour s'authentifier aupres d'une API. Le mode "Predefined Credential" offre des connecteurs preconfigures pour les services courants (Gmail, GitLab, Slack). Le mode "Generic Credential" permet de creer un OAuth2 ou un header auth de A a Z. L'approche la plus flexible : ne pas utiliser le champ Authentication et passer la cle d'API directement dans les headers ou les query parameters. Cette methode fonctionne avec toutes les API et reste la plus simple a configurer.

Exemple 1 : API ouverte (JSONPlaceholder)

JSONPlaceholder est une API de test gratuite, sans authentification. Pour recuperer un article : methode GET, URL https://jsonplaceholder.typicode.com/posts/1. La reponse contient un objet JSON avec id, title, body et userId. Pour creer un article : methode POST, header Content-Type: application/json; charset=UTF-8, body en JSON avec title, body et userId. Cet exemple illustre la lecture de documentation API et la transposition dans le noeud HTTP Request.

Exemple 2 : API authentifiee (Haloscan)

Haloscan est un outil SEO payant qui necessite une cle d'API. La configuration requiert trois headers : Accept: application/json, Content-Type: application/json et Haloscan-Api-Key: votre_cle. Le body contient le mot-cle a analyser et les donnees demandees (SERP, mots similaires). Chaque appel consomme des credits. Ce type d'integration est representatif des API professionnelles que l'on connecte dans les workflows n8n.

Options avancees

Le noeud HTTP Request dispose de nombreuses options pour gerer les cas complexes :

Retry on Fail : reessayer automatiquement en cas d'echec (jusqu'a 5 tentatives, avec intervalle configurable). Utile pour les API instables ou les modeles d'IA
On Error : choisir entre arreter le workflow, continuer (ignorer l'erreur) ou router vers une sortie d'erreur dediee
Pagination : parcourir automatiquement les pages de resultats quand l'API retourne les donnees par lots
Proxy : passer par un serveur intermediaire pour contourner les limitations d'IP
Timeout : definir un delai maximum d'attente avant de considerer que l'API ne repond pas
Batching : regrouper plusieurs requetes en une seule pour limiter les appels
Response Format : forcer le format attendu (JSON, fichier, texte) au lieu de la detection automatique

Guide des methodes HTTP

Cliquez sur une methode pour voir sa description, ses cas d'usage et un exemple de configuration n8n.

GET

Sans bodyIdempotent

Recupere des donnees sans modifier la ressource. La methode la plus courante, utilisee pour lire des APIs, scraper des pages ou verifier la disponibilite d'un service.

Cas d'usage courants

Lire une liste de produits depuis une API
Recuperer le profil d'un utilisateur
Verifier le statut d'une commande

Configuration dans n8n HTTP Request

URL

https://jsonplaceholder.typicode.com/posts/1

Reponse attendue

{
  "userId": 1,
  "id": 1,
  "title": "Titre du post",
  "body": "Contenu complet..."
}

Contenu détaillé

00:00Introduction et ajout du noeud

Presentation du noeud HTTP Request, utilise pour communiquer avec des API externes. Distinction entre API ouvertes (sans authentification) et API authentifiees (cle d'API requise). Ajout du noeud dans un workflow.

02:00Onglet Settings

Configuration des reglages generaux : SSL certificate, Always Output Data (continuer meme sans reponse), Retry on Fail (reessayer en cas d'echec), On Error (comportement en cas d'erreur). Note et Display Note pour documenter le noeud.

05:30Les methodes HTTP

Tour complet des 7 methodes HTTP : GET (lire), POST (creer), PUT (remplacer), PATCH (modifier partiellement), DELETE (supprimer), HEAD (en-tetes uniquement), OPTIONS (methodes autorisees). En pratique, GET et POST couvrent 90 % des usages.

09:00URL, authentification et query parameters

Configuration de l'URL cible, trois modes d'authentification (Predefined Credential, Generic Credential, ou manuelle via headers). Query parameters en mode champs individuels ou JSON. Demonstration avec JSONPlaceholder.

12:00Exemple API ouverte (JSONPlaceholder)

Requete GET pour lire un article, puis POST pour en creer un. Configuration des headers (Content-Type), du body en mode JSON expression avec doubles accolades. Erreur courante : oublier les doubles accolades pour le JSON en mode expression.

17:00Exemple API authentifiee (Haloscan)

Integration d'une API SEO payante : cle d'API dans les headers, body avec mot-cle et donnees demandees (SERP). Lecture d'une documentation API differente. Consommation de credits a chaque appel.

22:00Options avancees

Tour des options : Batching, Ignore SSL, Lowercase Headers, Redirect (suivi de redirections), Response (inclure headers et statut), Never Error, Response Format, Pagination automatique, Proxy (contourner les limites d'IP) et Timeout.

Questions fréquentes

Transcription complète

Pour aller plus loin

Ce tutoriel vous a été utile ? Contactez-moi pour un accompagnement personnalisé sur n8n.

← Toutes les ressources Prendre contact →