Bonjour ! Dans la leçon précédente, nous avons mis en place une stratégie essentielle pour la fiabilité de nos workflows : la gestion des erreurs avec le nœud Error Trigger. Cette compétence va s'avérer cruciale dès aujourd'hui, car nous abordons l'un des aspects les plus puissants et les plus sujets aux erreurs de l'automatisation : la communication avec le monde extérieur via des APIs.
Jusqu'à présent, nos workflows étaient relativement autonomes. Aujourd'hui, nous allons ouvrir les portes et apprendre à interroger et à interagir avec n'importe quel service externe disposant d'une API REST. Pour ce faire, nous allons maîtriser le nœud le plus polyvalent de n8n : le HTTP Request. En tant que développeur, les concepts de requêtes HTTP, de méthodes, et d'APIs REST vous sont familiers. Notre objectif sera donc de voir comment transposer ces connaissances dans l'environnement n8n pour configurer et exécuter ces appels de manière efficace.
Cette leçon vous apprendra à configurer le nœud HTTP Request pour effectuer des appels API, en nous concentrant sur les paramètres fondamentaux : la méthode, l'URL, les en-têtes (headers), les paramètres de requête (query parameters) et le corps de la requête (body).
Le Couteau Suisse de n8n : le Nœud HTTP Request
De nombreux services populaires (GitHub, Slack, Google Drive) ont leur propre nœud dédié dans n8n. Ces nœuds sont en réalité des abstractions du nœud HTTP Request, simplifiées pour un usage spécifique. Mais que faire lorsque vous devez interagir avec une API interne de votre entreprise, un service de niche, ou que vous avez besoin d'un contrôle total sur la requête ? C'est là que le nœud HTTP Request entre en jeu.

Ce nœud est votre passerelle universelle vers n'importe quelle API REST. Il vous permet de construire une requête HTTP pièce par pièce, exactement comme vous le feriez avec un outil comme cURL, Postman, ou avec fetch en JavaScript.
Pour bien comprendre les options qui s'offrent à nous, commençons par une lecture qui détaille la structure du nœud et les méthodes HTTP.
Noeud HTTP Request N8N : Guide Complet
Cet article de Ocade Fusion offre une excellente décomposition du nœud et de ses paramètres.
Lisez d'abord la section sur les méthodes HTTP pour un rappel rapide de leur rôle. Ensuite, parcourez la section "Configurer le panneau Parameters" qui présente les deux champs les plus importants que nous allons utiliser : Method et URL.
Requête GET : Récupérer des données externes
La méthode GET est la plus simple : elle sert à récupérer des informations. Pour notre premier exemple, nous allons utiliser JSONPlaceholder, une fausse API REST en ligne, parfaite pour les tests, car elle ne nécessite aucune authentification.
Notre but : récupérer les informations d'un "post" spécifique, par exemple celui avec l'ID 1.
La documentation de JSONPlaceholder nous dit que pour récupérer un post, l'URL est https://jsonplaceholder.typicode.com/posts/{id}.
La configuration dans n8n est donc directe :
- Ajoutez un nœud
HTTP Request. - Method :
GET(c'est la valeur par défaut). - URL :
https://jsonplaceholder.typicode.com/posts/1
Exécutez le nœud. Vous verrez en sortie un objet JSON contenant les données du post demandé. C'est aussi simple que ça.
Ajouter des Paramètres de Requête (Query Parameters)
Souvent, les requêtes GET sont affinées à l'aide de paramètres dans l'URL (ex: /search?query=n8n&page=1). Le nœud HTTP Request permet de les gérer de manière structurée.
Imaginons que nous voulions récupérer tous les posts écrits par l'utilisateur avec l'ID 1. La documentation de JSONPlaceholder indique l'URL /posts?userId=1.
Pour le faire dans n8n :
- URL :
https://jsonplaceholder.typicode.com/posts - Activez l'option Send Query Parameters.
- Dans la section
Query Parametersqui apparaît, cliquez surAdd parameter. - Name :
userId - Value :
1
En exécutant ce nœud, vous obtiendrez une liste d'items, chacun étant un post de cet utilisateur. Cette approche est plus propre et plus sûre que de construire manuellement la chaîne de requête dans l'URL, surtout lorsque les valeurs proviennent de nœuds précédents.
Requête POST : Envoyer des données
Passons maintenant à la création de données avec la méthode POST. Cela nous amène à deux nouvelles sections importantes du nœud : les Headers et le Body.

Nous allons créer un nouveau post sur JSONPlaceholder. Pour cela, nous devons :
- Changer la méthode en
POST. - Envoyer les données du post dans le corps (
Body) de la requête. - Indiquer au serveur le format des données que nous envoyons via l'en-tête (
Header)Content-Type.
L'article suivant détaille justement la configuration de ces sections.
Noeud HTTP Request N8N : Guide Complet
Continuons notre exploration des paramètres du nœud.
Lisez les sections sur les Headers et le Body pour comprendre leur rôle. Ensuite, suivez l'exemple pratique de la requête POST vers JSONPlaceholder, qui met tout cela en application.
Pour recréer cet exemple dans votre workflow :
- Configurez le nœud
HTTP Request:- Method :
POST - URL :
https://jsonplaceholder.typicode.com/posts
- Method :
- Activez Send Headers et ajoutez un en-tête :
- Name :
Content-Type - Value :
application/json; charset=UTF-8
- Name :
- Activez Send Body et laissez Body Content Type sur
JSON. - Dans le champ
JSON, collez l'objet JSON à envoyer :{ "title": "Mon premier post via n8n", "body": "C'est assez simple finalement !", "userId": 1 }
Exécutez le nœud. L'API vous retournera l'objet que vous avez envoyé, complété par un nouvel id généré par le serveur.
Un exemple concret en vidéo
Maintenant que nous avons vu les bases, regardons un tutoriel vidéo qui met ces concepts en pratique avec des APIs réelles. La vidéo aborde des notions d'authentification que nous verrons en détail dans la prochaine leçon, mais concentrez-vous sur la manière dont le présentateur trouve les informations dans la documentation de l'API et les retranscrit dans le nœud n8n.
API pour Débutants : Maîtriser la requête HTTP dans N8N (Guide Complet)
Cette vidéo de Julien Sanson est un excellent guide pratique.
Regardez la première partie (introduction aux méthodes) pour un rappel visuel des différentes méthodes HTTP. Ensuite, suivez l'exemple de la requête GET pour une API météo (Weather API). Observez comment il lit la documentation pour trouver l'URL de base, le "endpoint", et les paramètres de requête (key et q). Portez une attention particulière à la fonction Import cURL, un outil très puissant pour les développeurs. Enfin, regardez l'exemple de la requête POST pour générer une image (génération d'image). Ici, l'accent est mis sur l'envoi de données dans le Body et la configuration des Headers (Content-Type et Authorization). Ne vous préoccupez pas des détails de la gestion des "credentials" pour le moment, nous y reviendrons. L'important est de voir le processus : lire la doc, configurer le nœud.
Comme le souligne la vidéo, le réflexe fondamental est toujours de se référer à la documentation de l'API que vous souhaitez utiliser. Elle est la seule source de vérité sur les URLs à appeler, les méthodes à utiliser, et les données à envoyer.
Conclusion
Aujourd'hui, vous avez ajouté l'un des outils les plus fondamentaux de l'automatisation à votre arsenal. Le nœud HTTP Request est la clé qui vous permettra de connecter n8n à une infinité de services, y compris les modèles d'IA que nous étudierons bientôt.
Voici les points essentiels à retenir :
- Le nœud HTTP Request est l'outil universel pour communiquer avec n'importe quelle API REST.
- La méthode HTTP (
GET,POST, etc.) et l'URL de l'endpoint sont les paramètres de base de toute requête. - Pour les requêtes
GET, les filtres et paramètres sont souvent passés via les Query Parameters. - Pour les requêtes
POSTouPUT, les données à envoyer sont placées dans le Body, et le format de ces données est spécifié dans les Headers (généralementContent-Type: application/json). - La documentation de l'API est votre meilleure amie. Apprendre à la lire et à traduire ses spécifications en une configuration de nœud n8n est la compétence clé.
Dans la prochaine leçon, nous allons nous attaquer au sujet que nous avons volontairement mis de côté aujourd'hui : l'authentification. Nous verrons comment gérer les clés API et autres secrets de manière sécurisée en utilisant le système de credentials de n8n, ce qui nous permettra de nous connecter à des services protégés comme l'API GitHub ou les APIs d'IA.