🇫🇷 HTTP Request

Accueil » 📂N8N » 📂Noeuds » 🇫🇷 HTTP Request

Contacter Ocade Fusion

Le nœud HTTP Request est l’outil universel de N8N pour communiquer avec n’importe quel service externe via une API. Que vous souhaitiez récupérer des données depuis une API ouverte, envoyer des informations à un CRM, ou interroger un outil SEO comme Haloscan, ce nœud vous donne un contrôle total sur vos requêtes. Ce guide vous accompagne dans la maîtrise des méthodes HTTP, la configuration des headers et du body, l’authentification par clé API, et les options avancées comme la pagination et la gestion des erreurs.

Qu’est-ce que le nœud HTTP Request ?

Le HTTP Request est un nœud N8N qui permet d’envoyer des requêtes vers n’importe quelle URL et de récupérer la réponse. C’est la brique fondamentale pour intégrer des services qui n’ont pas de nœud dédié dans N8N, ou pour des cas d’usage spécifiques nécessitant un contrôle précis sur la requête.

Concrètement, ce nœud reproduit ce que fait un navigateur ou un outil comme Postman : il envoie une requête HTTP (GET, POST, PUT, etc.) à une URL, avec des paramètres, des headers et un body si nécessaire, puis retourne la réponse au format JSON, texte ou fichier.

Comprendre les méthodes HTTP

Chaque API définit quelle méthode utiliser pour chaque action. Voici les principales méthodes et leur usage standard.

GET : récupérer des données

La méthode GET sert à lire ou consulter une ressource. C’est l’équivalent de taper une URL dans votre navigateur. Exemple : récupérer la liste des produits, consulter les détails d’un utilisateur, obtenir les résultats d’une recherche.

POST : envoyer des données

La méthode POST permet de créer une nouvelle ressource ou d’envoyer des données au serveur. Exemple : soumettre un formulaire, créer un nouvel utilisateur, envoyer un message. Les données sont transmises dans le body de la requête.

PUT : remplacer une ressource

La méthode PUT remplace entièrement une ressource existante. Vous envoyez l’intégralité des données de l’objet, même les champs qui ne changent pas. Exemple : mettre à jour complètement le profil d’un utilisateur.

PATCH : mise à jour partielle

La méthode PATCH modifie uniquement certains champs d’une ressource. Contrairement à PUT, vous n’envoyez que les données à modifier. Exemple : changer uniquement l’email d’un utilisateur sans toucher aux autres informations.

DELETE : supprimer une ressource

La méthode DELETE supprime une ressource sur le serveur. Exemple : supprimer un utilisateur, retirer un produit du catalogue, effacer un commentaire.

En pratique, la majorité des cas d’usage impliquent les méthodes GET et POST. Les autres méthodes (HEAD, OPTIONS) sont rarement utilisées dans les workflows d’automatisation.

Configurer le panneau Settings

Le panneau Settings contient les réglages de comportement du nœud, communs à la plupart des nœuds N8N.

• SSL Certificate : à activer uniquement si l’API requiert un certificat client pour l’authentification. Très rare.
• Always Output Data : si activé, le workflow continue même si l’API ne retourne aucune donnée. Utile pour éviter les blocages.
• Execute Once : exécute le nœud une seule fois, même si plusieurs items arrivent en entrée. Pratique pour les tests.
• Retry On Fail : relance automatiquement la requête en cas d’échec. Configurez le nombre maximum de tentatives (jusqu’à 5) et l’intervalle entre chaque essai.
• On Error : définit le comportement en cas d’erreur. Par défaut, le workflow s’arrête. Vous pouvez choisir de continuer ou de prendre une branche alternative.
• Note et Display Note In Flow : ajoutez une description sous le nœud pour documenter son rôle (exemple : « API Haloscan – Récupération SERP »).

Configurer le panneau Parameters

Le panneau Parameters contient les réglages essentiels de la requête HTTP.

Method et URL

Sélectionnez la méthode HTTP (GET, POST, PUT, PATCH, DELETE) selon la documentation de l’API. Collez l’URL complète de l’endpoint dans le champ URL. Cette URL peut contenir des variables N8N si vous avez besoin de la construire dynamiquement.

Authentication

Trois options sont disponibles :

• Predefined Credential Type : utilisez un credential N8N existant (Gmail, GitLab, etc.) si l’API est déjà supportée.
• Generic Credential Type : construisez une authentification personnalisée (OAuth2, API Key, Basic Auth).
• None : aucune authentification intégrée. Passez la clé API manuellement dans les headers ou les query parameters. C’est souvent la méthode la plus simple et flexible.

Query Parameters

Les query parameters sont les paramètres ajoutés à l’URL après le point d’interrogation (exemple : ?page=2&limit=10). Activez Send Query Parameters et choisissez entre :

• Using Fields Below : ajoutez les paramètres sous forme de paires clé/valeur. Plus lisible et facile à maintenir.
• Using JSON : envoyez les paramètres au format JSON. Utile pour des structures complexes.

Headers

Les headers transmettent des métadonnées avec la requête. Les plus courants :

• Content-Type : indique le format des données envoyées. Généralement application/json pour les API REST.
• Accept : indique le format de réponse attendu. Généralement application/json.
• Authorization ou clé API personnalisée : contient le token ou la clé d’authentification.

Activez Send Headers et ajoutez vos headers sous forme de paires clé/valeur.

Body

Le body contient les données envoyées au serveur (uniquement pour POST, PUT, PATCH). Activez Send Body et choisissez le format :

• Using JSON : collez directement un objet JSON. Passez en mode Expression (icône à droite du champ) si vous devez construire le JSON dynamiquement avec des variables N8N.
• Using Fields Below : ajoutez les données sous forme de paires clé/valeur.
• Raw : envoyez du texte brut ou un format personnalisé.

Exemple 1 : API ouverte (JSONPlaceholder)

JSONPlaceholder est une API de test gratuite, sans authentification. Parfaite pour apprendre à utiliser le nœud HTTP Request.

Requête GET : récupérer un article

• Method : GET
• URL : https://jsonplaceholder.typicode.com/posts/1
• Authentication : None
• Pas de headers ni de body nécessaires

Exécutez le nœud : vous obtenez un objet JSON contenant l’ID, le titre, le body et l’userId de l’article numéro 1.

Requête POST : créer un article

• Method : POST
• URL : https://jsonplaceholder.typicode.com/posts
• Headers : Content-Type: application/json; charset=UTF-8
• Body (Using JSON) :

{
  "title": "Mon nouvel article",
  "body": "Contenu de l'article créé via N8N",
  "userId": 1
}

L’API retourne l’article créé avec un nouvel ID généré.

Exemple 2 : API avec authentification (Haloscan)

Haloscan est un outil SEO qui fournit des données sur les mots-clés et les SERP. L’accès nécessite une clé API.

Configuration de la requête

• Method : POST
• URL : https://app.haloscan.com/api/keywords-overview
• Headers :

Accept: application/json
Content-Type: application/json
haloscan_api_key: VOTRE_CLE_API

• Body (Using JSON) :

{
  "data": {
    "keyword": "coupe du monde de football",
    "request_data": ["serp"],
    "lang": "fr"
  }
}

L’API retourne les résultats de recherche Google (SERP) pour le mot-clé demandé, avec les positions, URLs et métriques associées.

Options avancées du nœud

Le nœud HTTP Request propose des options avancées pour gérer les cas complexes.

Batching

Permet de regrouper plusieurs requêtes en un seul appel si l’API le supporte. Réduit le nombre d’appels et améliore les performances.

Ignore SSL Issues

Désactive la vérification du certificat SSL. À utiliser uniquement pour des API internes en HTTP ou avec des certificats auto-signés. Attention : les données transitent en clair, ce n’est pas sécurisé pour des données sensibles.

Lowercase Headers

Force tous les noms de headers en minuscules. Certaines API sont sensibles à la casse et n’acceptent que des headers en minuscules.

Redirect

Permet de suivre automatiquement les redirections HTTP (codes 301, 302). Si désactivé et que l’API redirige, la requête échoue.

Response

Inclut les headers et le code de statut HTTP dans la réponse. Utile pour gérer les erreurs : un code 200 indique un succès, 400 ou 500 une erreur. Vous pouvez ensuite utiliser un nœud IF pour router le workflow selon le statut.

Never Error

Empêche le nœud de générer une erreur, même si l’API retourne un code d’erreur (400, 500). Le workflow continue normalement. Combinez avec l’option Response pour gérer les erreurs manuellement.

Pagination

Gère automatiquement les API qui retournent les données en plusieurs pages. Configurez le paramètre de page (exemple : page) et utilisez la variable $response pour extraire le numéro de la page suivante depuis la réponse de l’API.

Proxy

Route les requêtes via un serveur proxy. Utile si l’API limite les appels par adresse IP ou si vous devez contourner des restrictions géographiques.

Timeout

Définit le délai maximum d’attente pour une réponse (en millisecondes). Si l’API ne répond pas dans ce délai, la requête est interrompue. Évite les blocages sur des API lentes ou en panne.

Bonnes pratiques

• Documentez vos nœuds : renommez chaque nœud HTTP Request avec un nom explicite (exemple : « Haloscan – SERP ») et ajoutez une note décrivant l’API utilisée.
• Testez avec des API ouvertes : JSONPlaceholder, ReqRes ou httpbin.org sont parfaits pour apprendre sans risque.
• Activez Retry On Fail pour les API instables ou les modèles IA qui peuvent temporairement échouer.
• Gérez les erreurs : utilisez l’option Response pour récupérer le code de statut et routez le workflow avec un nœud IF.
• Sécurisez vos clés API : utilisez les credentials N8N plutôt que de hardcoder les clés dans le JSON.
• Lisez la documentation : chaque API a ses spécificités. La documentation vous indique la méthode, l’URL, les headers et le format du body attendus.

Comment envoyer une clé API dans une requête HTTP Request N8N vers une API comme Haloscan ?

Activez 'Send Headers' et ajoutez une paire clé/valeur avec le nom du header d'authentification (exemple : haloscan_api_key) et votre clé API comme valeur. C'est la méthode la plus flexible pour les API qui attendent la clé dans les headers. Ajoutez la clé API directement dans l'URL après un point d'interrogation, par exemple : ?api_key=VOTRE_CLE. Toutes les API REST acceptent ce format standardisé. Créez un fichier .env sur votre serveur N8N contenant la variable HALOSCAN_KEY, puis référencez-la dans le nœud avec la syntaxe ${HALOSCAN_KEY}. Sélectionnez 'Predefined Credential Type' dans Authentication et choisissez Haloscan dans la liste déroulante. N8N gère automatiquement l'authentification via OAuth2.

Conclusion

Le nœud HTTP Request est l’outil universel pour connecter N8N à n’importe quelle API. En maîtrisant les méthodes HTTP, la configuration des headers et du body, et les options avancées comme la pagination et la gestion des erreurs, vous pouvez intégrer pratiquement n’importe quel service externe dans vos workflows.

Le point clé à retenir : lisez toujours la documentation de l’API avant de configurer votre nœud. Elle vous indique la méthode, l’URL, les headers requis et le format du body. Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour concevoir des intégrations API adaptées à vos besoins métier.

Vous recherchez d’autres contenus ?