Comment utiliser le nœud HTTP Request dans n8n
Chapitres
Résumé
Le nœud HTTP Request est le nœud le plus polyvalent de n8n. Il permet de communiquer avec n'importe quelle API REST : récupèrer des données (GET), envoyer des informations (POST), mettre à jour des ressources (PUT/PATCH) ou les supprimer (DELETE). Ce guide couvre la configuration complète du nœud, des méthodes HTTP à 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 clés
- 7 méthodes HTTP supportées : 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 avancées : pagination automatique, proxy, timeout, batching, redirect
- Present dans la quasi-totalite des workflows en production
Methodes HTTP : quand utiliser laquelle
Chaque méthode HTTP à un rôle spécifique, même si toutes les API ne respectent pas strictement ces conventions :
- GET : récupèrer des données. Lire, consulter une ressource. La plus utilisee
- POST : envoyer des données. Creer une ressource, soumettre un formulaire
- PUT : remplacer entièrement une ressource existante. Mise à jour complète
- PATCH : mettre à jour partiellement une ressource. Modifier un seul champ
- DELETE : supprimer une ressource
- HEAD : récupèrer uniquement les en-têtes, sans le corps de la réponse
- OPTIONS : vérifier les méthodes autorisées sur une ressource (CORS)
En pratique, GET et POST représentent plus de 90 % des appels dans un workflow n8n.
Configurer une requête : URL, headers et body
La configuration suit trois étapes : définir la méthode et l'URL, ajouter les headers si requis par l'API, et renseigner le body pour les méthodes 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 exécuter du code JavaScript.
Authentification et clés d'API
Trois approches existent pour s'authentifier aupres d'une API. Le mode "Predefined Credential" offre des connecteurs préconfigurés pour les services courants (Gmail, GitLab, Slack). Le mode "Generic Credential" permet de créer un OAuth2 ou un header auth de A a Z. L'approche la plus flexible : ne pas utiliser le champ Authentication et passer la clé d'API directement dans les headers ou les query parameters. Cette méthode fonctionne avec toutes les API et reste la plus simple à configurer.
Exemple 1 : API ouverte (JSONPlaceholder)
JSONPlaceholder est une API de test gratuite, sans authentification. Pour récupèrer un articlé : méthode GET, URL https://jsonplaceholder.typicode.com/posts/1. La réponse contient un objet JSON avec id, title, body et userId. Pour créer un articlé : méthode 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 nœud HTTP Request.
Exemple 2 : API authentifiee (Haloscan)
Haloscan est un outil SEO payant qui nécessite une clé d'API. La configuration requiert trois headers : Accept: application/json, Content-Type: application/json et Haloscan-Api-Key: votre_clé. Le body contient le mot-clé à analyser et les données demandees (SERP, mots similaires). Chaque appel consomme des credits. Ce type d'intégration est representatif des API professionnelles que l'on connecte dans les workflows n8n.
Options avancées
Le nœud HTTP Request dispose de nombreuses options pour gérer les cas complexes :
- Retry on Fail : réessayer automatiquement en cas d'échec (jusqu'a 5 tentatives, avec intervalle configurable). Utile pour les API instables ou les modèles d'IA
- On Error : choisir entre arreter le workflow, continuer (ignorer l'erreur) ou router vers une sortie d'erreur dédiée
- Pagination : parcourir automatiquement les pages de résultats quand l'API retourne les données par lots
- Proxy : passer par un serveur intermédiaire pour contourner les limitations d'IP
- Timeout : définir un délai maximum d'attente avant de considerer que l'API ne répond pas
- Batching : regrouper plusieurs requêtes en une seule pour limiter les appels
- Response Format : forcer le format attendu (JSON, fichier, texte) au lieu de la detection automatique
Guide des méthodes HTTP
Cliquez sur une méthode pour voir sa description, ses cas d'usage et un exemple de configuration n8n.
Récupère des données sans modifier la ressource. La méthode la plus courante, utilisée pour lire des APIs, scraper des pages ou vérifier la disponibilité d'un service.
Cas d'usage courants
- Lire une liste de produits depuis une API
- Récupérer le profil d'un utilisateur
- Vérifier le statut d'une commande
https://jsonplaceholder.typicode.com/posts/1{
"userId": 1,
"id": 1,
"title": "Titre du post",
"body": "Contenu complet..."
}Contenu détaillé
00:00Introduction et ajout du nœud
Presentation du nœud HTTP Request, utilise pour communiquer avec des API externes. Distinction entre API ouvertes (sans authentification) et API authentifiees (clé d'API requise). Ajout du nœud dans un workflow.
02:00Onglet Settings
Configuration des réglages généraux : SSL certificate, Always Output Data (continuer même sans réponse), Retry on Fail (réessayer en cas d'échec), On Error (comportement en cas d'erreur). Note et Display Note pour documenter le nœud.
05:30Les méthodes HTTP
Tour complet des 7 méthodes HTTP : GET (lire), POST (créer), PUT (remplacer), PATCH (modifier partiellement), DELETE (supprimer), HEAD (en-têtes uniquement), OPTIONS (méthodes autorisées). 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)
Requête GET pour lire un article, puis POST pour en créer 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 authentifiée (Haloscan)
Intégration d'une API SEO payante : clé d'API dans les headers, body avec mot-clé et données demandées (SERP). Lecture d'une documentation API différente. Consommation de crédits à chaque appel.
22:00Options avancées
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.