Requêtes HTTP Avancées avec Node-RED

1. Les Méthodes HTTP : Le Langage des APIs

Chaque interaction avec une API repose sur une "méthode" HTTP, qui indique au serveur l'action que vous souhaitez effectuer. Étant donné votre profil technique, vous pouvez voir cela comme les opérations CRUD (Create, Read, Update, Delete) appliquées aux ressources web.

Voici les quatre méthodes que nous allons maîtriser aujourd'hui :

• GET : Pour lire ou récupérer des données. C'est l'opération la plus courante. Quand vous visitez une page web, votre navigateur effectue une requête GET.
• POST : Pour créer une nouvelle ressource sur un serveur. Par exemple, publier un nouvel article de blog, ajouter un contact dans un CRM, ou envoyer un formulaire.
• PUT : Pour remplacer entièrement une ressource existante. Vous devez envoyer l'objet complet, même si vous ne modifiez qu'un seul champ.
• DELETE : Pour supprimer une ressource.

Une autre méthode, PATCH, est souvent utilisée pour des mises à jour partielles, mais nous nous concentrerons sur les quatre principales, qui couvrent la grande majorité des cas.

Pour une description textuelle détaillée de chaque méthode, je vous invite à lire la section suivante.

2. Anatomie d'une Requête dans le Nœud HTTP Request

Le nœud HTTP Request est votre interface pour construire et envoyer ces requêtes. Au-delà de la méthode, plusieurs paramètres sont essentiels.

• Method : Le type de requête (GET, POST, etc.).
• URL : L'adresse de la ressource que vous visez, aussi appelée endpoint.
• Authentication : La manière de prouver votre identité à l'API. Nous y reviendrons en détail dans la prochaine leçon. Pour l'instant, nous gérerons l'authentification manuellement.
• Send Query Parameters : Des paires clé/valeur ajoutées à la fin de l'URL (après un ?) pour filtrer ou spécifier une requête GET. Exemple : ?limit=10&status=active.
• Send Headers : Des méta-informations envoyées avec la requête, comme le format des données (Content-Type) ou une clé d'authentification (Authorization).
• Send Body : Le contenu principal de la requête, utilisé avec POST et PUT pour envoyer les données à créer ou à mettre à jour, généralement au format JSON.

La vidéo suivante est une démonstration très claire de la configuration d'une requête POST complexe. Elle illustre parfaitement comment la documentation d'une API se traduit dans les champs du nœud n8n.

3. Exercice Pratique : Le Cycle de Vie d'un Article avec JSONPlaceholder

Pour mettre en pratique ces concepts, nous allons utiliser JSONPlaceholder, une API de test gratuite et ouverte qui simule un blog. Elle est parfaite pour s'exercer sans avoir besoin de clé API. Notre objectif est d'effectuer le cycle de vie complet d'un article de blog : le créer, le lire, le mettre à jour, puis le supprimer.

Créez un nouveau workflow dans n8n et suivez les étapes ci-dessous.

Étape 1 : Récupérer un article existant (GET)

Commençons par quelque chose de simple : récupérer l'article avec l'ID 1.

1. Ajoutez un nœud HTTP Request.
2. Configurez-le comme suit :
   • Method : GET
   • URL : https://jsonplaceholder.typicode.com/posts/1
3. Exécutez le nœud. Vous devriez recevoir en sortie un objet JSON contenant les détails de l'article n°1.

Étape 2 : Créer un nouvel article (POST)

Maintenant, créons notre propre article.

1. Ajoutez un nouveau nœud HTTP Request (ou modifiez le précédent).
2. Configurez-le :
   • Method : POST
   • URL : https://jsonplaceholder.typicode.com/posts
   • Activez Send Headers et ajoutez une propriété :
     • Name: Content-Type
     • Value: application/json
       (Ceci indique au serveur que les données que nous envoyons dans le corps sont au format JSON.)
   • Activez Send Body. Laissez le Body Content Type sur JSON.
   • Cliquez sur Add Property et ajoutez les champs suivants :
     • Name: title, Value: Mon article n8n
     • Name: body, Value: Ceci est un article créé via n8n.
     • Name: userId, Value: 10
3. Exécutez le nœud. L'API vous renverra l'objet que vous venez de créer, complété par un nouvel id (probablement 101).

Étape 3 : Mettre à jour l'article (PUT)

Mettons à jour l'article que nous venons de créer (ou l'article 1 si vous préférez). La méthode PUT remplace l'intégralité de la ressource.

1. Ajoutez un nouveau nœud HTTP Request.
2. Configurez-le :
   • Method : PUT
   • URL : https://jsonplaceholder.typicode.com/posts/1 (ou l'ID que vous avez reçu à l'étape POST).
   • Configurez les Headers et le Body exactement comme pour la requête POST, mais avec un contenu différent dans le corps pour voir la mise à jour. Par exemple :
     • title: Mon article a été mis à jour
     • body: Le contenu a changé.
     • userId: 10
3. Exécutez le nœud. La réponse de l'API doit contenir vos nouvelles données. Si vous aviez omis un champ (par exemple, userId), il aurait été effacé sur le serveur, car PUT est un remplacement complet.

Étape 4 : Supprimer l'article (DELETE)

Pour finir, nettoyons en supprimant l'article.

1. Ajoutez un dernier nœud HTTP Request.
2. Configurez-le :
   • Method : DELETE
   • URL : https://jsonplaceholder.typicode.com/posts/1
3. Exécutez le nœud. La réponse sera probablement un objet vide {}, ce qui est normal pour une suppression réussie. Pour vérifier que l'article a bien été supprimé, essayez de refaire la requête GET de l'étape 1 ; vous devriez obtenir une erreur 404 (Not Found).

Conclusion

Félicitations ! Vous avez maintenant une compréhension pratique et solide des opérations fondamentales qui régissent la quasi-totalité des API REST.

Points clés à retenir :

• Le nœud HTTP Request est votre outil universel pour communiquer avec n'importe quel service web.
• Les méthodes GET, POST, PUT, DELETE correspondent aux actions de lecture, création, mise à jour et suppression.
• Une requête POST ou PUT nécessite généralement un Header Content-Type et un Body contenant les données à envoyer au format JSON.
• Lire la documentation de l'API est la première étape indispensable pour savoir quelle méthode, URL, et quels paramètres utiliser.

Dans la prochaine leçon, nous franchirons une étape cruciale en matière de sécurité et de bonnes pratiques : nous apprendrons à gérer l'authentification de manière sécurisée et réutilisable avec le système de Credentials de n8n. Fini les clés API en clair dans les en-têtes