Comment connecter une API REST à n8n ? La méthode universelle
Connecter une API REST à n8n consiste à ajouter un nœud HTTP Request, renseigner l’URL et la méthode HTTP, configurer l’authentification via des credentials sécurisés, puis lire la réponse JSON pour l’utiliser dans les nœuds suivants. C’est la méthode la plus universelle : elle fonctionne avec n’importe quel service qui expose une API, même sans connecteur natif dans n8n.
Vous ajoutez un nœud HTTP Request, vous renseignez l’URL et la méthode de l’API, vous configurez l’authentification avec des credentials n8n, puis vous utilisez la réponse JSON dans le reste du workflow.
Qu’est-ce que le nœud HTTP Request dans n8n ?
La plupart des outils métier proposent une API REST, mais tous n’ont pas de connecteur natif dans n8n. Le nœud HTTP Request comble cet écart : il envoie une requête directement vers n’importe quelle URL, sans dépendre d’une intégration prête à l’emploi.
L’adresse de l’endpoint, généralement indiquée dans la documentation officielle de l’API.
GET pour lire une donnée, POST pour en créer une, PUT ou PATCH pour la modifier, DELETE pour la supprimer.
La clé, le jeton ou les identifiants exigés par l’API pour accepter la requête.
À l’inverse des webhooks, qui reçoivent des données entrantes, le nœud HTTP Request envoie une requête sortante et attend une réponse. La documentation officielle du nœud HTTP Request détaille l’ensemble des options disponibles, dont la pagination automatique et la gestion des fichiers binaires.
Comment connecter une API REST à n8n, étape par étape ?
Si vous découvrez n8n, notre tutoriel pour créer un premier workflow couvre les bases du canevas. Voici la suite, spécifique à la connexion d’une API externe.
- Trouvez la documentation de l’APIRepérez l’URL de base, les endpoints disponibles et le format d’authentification exigé. Notre guide pour débuter avec la documentation n8n aide à prendre ce réflexe.
- Ajoutez un nœud HTTP RequestRecherchez « HTTP Request » dans la liste des nœuds et connectez-le à l’étape précédente de votre workflow.
- Choisissez la méthode HTTPSélectionnez GET, POST, PUT ou DELETE selon l’action à effectuer sur la ressource visée.
- Renseignez l’URLCollez l’endpoint exact, en insérant si besoin des variables issues des nœuds précédents entre accolades doubles.
- Configurez l’authentificationChoisissez le type attendu par l’API (clé, jeton, identifiants) puis créez des credentials dédiés plutôt que de les écrire en dur.
- Ajoutez les paramètres et le corpsRenseignez les query parameters, en-têtes ou le corps JSON attendus par l’API pour cet endpoint.
- Exécutez le nœud pour testerCliquez sur « Execute step » et vérifiez la réponse affichée dans le panneau de sortie.
- Exploitez la réponseUtilisez les données JSON reçues dans les nœuds suivants du workflow, comme n’importe quel autre résultat.
Comment gérer l’authentification d’une API ?
Chaque API impose sa propre méthode pour vérifier qu’une requête est autorisée. Le nœud HTTP Request propose plusieurs types d’authentification prédéfinis, à choisir selon ce qu’exige la documentation du service visé.
| Méthode | Où passe l’information | Cas d’usage typique |
|---|---|---|
| Clé API | Query parameter ou en-tête personnalisé | APIs simples, souvent à usage interne ou de test. |
| Bearer Token | En-tête Authorization | APIs modernes, jetons à durée de vie limitée. |
| Basic Auth | En-tête encodé (identifiant + mot de passe) | APIs plus anciennes, identifiants fixes. |
| OAuth2 | Flux d’échange de jetons géré par n8n | Google, Microsoft, services exigeant un consentement utilisateur. |
La documentation des identifiants génériques HTTP détaille la configuration de chacune de ces méthodes directement dans n8n.
Pourquoi utiliser les credentials plutôt qu’une clé en dur ?
Il est possible de coller une clé API directement dans l’URL ou les en-têtes d’un nœud HTTP Request. C’est une mauvaise pratique : la clé apparaît alors en clair dans les journaux d’exécution et devient plus difficile à faire tourner en cas de fuite.
Les identifiants créés via le système de credentials sont chiffrés et réutilisables sur plusieurs workflows, sans jamais apparaître en clair dans les nœuds ni dans les exports JSON.
Ce fonctionnement rejoint un principe déjà valable pour les webhooks entrants : mieux vaut isoler ce qui est sensible dans un espace dédié plutôt que de le mélanger à la logique du workflow.
Comment exploiter la réponse JSON reçue ?
Par défaut, n8n interprète automatiquement une réponse au format JSON et l’affiche sous forme de champs exploitables dans le panneau de sortie du nœud. Chaque champ devient ensuite accessible depuis les nœuds suivants via une expression, par exemple pour filtrer, transformer ou envoyer cette donnée ailleurs.
La documentation sur la structure des données dans n8n explique comment ces informations circulent d’un nœud à l’autre et comment lire un champ imbriqué dans une réponse complexe.
Comment gérer les erreurs et les limites de l’API ?
Une API externe peut répondre par une erreur (mauvaise requête, authentification refusée, quota dépassé) ou simplement ne pas répondre à temps. Un workflow robuste anticipe ces cas plutôt que de s’arrêter brutalement.
Bonnes pratiques à adopter
- Activer « Continue on Fail » pour les appels non critiques.
- Définir un délai d’expiration (timeout) raisonnable.
- Prévoir une nouvelle tentative en cas d’erreur temporaire.
- Journaliser les codes de réponse pour diagnostiquer plus vite.
Erreurs fréquentes à éviter
- Ignorer les codes 4xx et 5xx renvoyés par l’API.
- Appeler une API à un rythme supérieur à son quota autorisé.
- Oublier de vérifier le format exact attendu par l’endpoint.
- Laisser un workflow entier échouer pour une seule requête ratée.
La documentation sur la gestion des erreurs dans n8n détaille les options disponibles au niveau du nœud et du workflow.
Comment connectons-nous les API chez Amari Agency ?
Voici un exemple représentatif de notre méthode, sans donnée client ni promesse de résultat garantie.
Des credentials dédiés pour chaque API externe
Nos workflows n8n appellent régulièrement des API tierces (facturation, vérification d’entreprise, envoi transactionnel) via le nœud HTTP Request. Nous créons systématiquement des credentials séparés par service, activons un délai d’expiration raisonnable et journalisons les réponses avant de les transmettre à Supabase ou de déclencher un envoi via Resend.
Quels cas d’usage concrets pour le nœud HTTP Request ?
Enrichir un CRM
Interroger une API de vérification d’entreprise pour compléter automatiquement une fiche client.
Synchroniser des données
Récupérer les commandes d’une plateforme externe pour les intégrer à un tableau de bord interne.
Notifier un service tiers
Envoyer un événement vers une API externe dès qu’une action se produit dans le workflow.
Interroger un modèle d’IA
Appeler l’API d’un modèle de langage pour générer un texte, un résumé ou une réponse au sein d’un agent IA construit dans n8n.
Pour aller plus loin sur l’intégration de fournisseurs d’IA, notre page dédiée présente nos solutions d’automatisation IA sur mesure, du cadrage à la mise en production.
Quels contenus lire ensuite ?
Ces ressources complètent ce tutoriel sans cibler la même requête :
Questions fréquentes sur la connexion d’une API REST à n8n
Faut-il coder pour connecter une API REST à n8n ?
Non, le nœud HTTP Request se configure entièrement dans l’interface visuelle. Des notions techniques aident surtout pour comprendre la documentation de l’API et déboguer une réponse inattendue.
Peut-on connecter une API qui n’a pas de connecteur natif dans n8n ?
Oui, c’est justement le rôle du nœud HTTP Request : il fonctionne avec n’importe quelle API REST, qu’elle dispose ou non d’une intégration dédiée dans n8n.
Comment savoir quelle méthode d’authentification utiliser ?
La documentation officielle de l’API indique toujours la méthode attendue : clé API, Bearer token, Basic Auth ou OAuth2. Il faut ensuite créer les credentials correspondants dans n8n.
Que faire si l’API renvoie une erreur 429 (trop de requêtes) ?
Cette erreur signale un quota dépassé. Espacez les appels, ajoutez une pause entre les exécutions ou vérifiez les limites de débit indiquées par la documentation de l’API.
Les données envoyées à une API externe sont-elles sécurisées ?
Les requêtes HTTP Request utilisent le chiffrement HTTPS lorsque l’API le propose. La sécurité dépend aussi de la protection des credentials et du périmètre exact des données envoyées.