TP: Création, mise à jour et suppression de ressources via API REST

1. Les Méthodes HTTP pour la Manipulation de Données

Si la méthode GET sert à récupérer des données, les méthodes POST, PUT, PATCH, et DELETE sont utilisées pour les modifier. Votre expérience en tant que consultant IT vous a sans doute déjà familiarisé avec ces verbes HTTP, mais un rappel dans le contexte de n8n est toujours utile.

Pour une description claire de chaque méthode, je vous invite à lire le court extrait suivant.

En résumé :

• POST : Crée une nouvelle ressource.
• PUT : Remplace une ressource existante dans son intégralité.
• PATCH : Met à jour partiellement une ressource existante.
• DELETE : Supprime une ressource existante.

Dans n8n, le choix de la méthode se fait simplement via un menu déroulant dans le nœud HTTP Request, comme le montre l'image ci-dessous.

2. Guide de l'Exercice : Construire le Workflow CRUD

Notre workflow sera une séquence de trois nœuds HTTP Request. Le point crucial est de comprendre comment la sortie d'un nœud devient l'entrée du suivant.

Étape 1 : Créer un article (POST)

Le premier nœud va créer un nouvel article de blog fictif sur JSONPlaceholder.

1. Ajoutez un nœud HTTP Request à votre canvas.
2. Method : POST
3. URL : https://jsonplaceholder.typicode.com/posts
4. Activez l'option Send Body.
5. Body Content Type : JSON.
6. Specify Body : Using JSON.
7. Dans le champ JSON, collez le contenu suivant :

   {
     "title": "Mon premier article avec n8n",
     "body": "Ceci est le contenu de mon article.",
     "userId": 1
   }
   

L'article de Ocade Fusion donne un exemple similaire que vous pouvez consulter.

Exécutez ce nœud. La réponse de l'API doit être un objet JSON représentant votre article, mais avec un champ id ajouté (par exemple, 101). Cet id est essentiel pour les étapes suivantes.

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

Le deuxième nœud va modifier l'article que nous venons de créer.

1. Ajoutez un second nœud HTTP Request après le premier.
2. Method : PUT
3. URL : Ici, nous devons construire l'URL dynamiquement en utilisant l'ID de l'étape précédente. L'URL doit ressembler à https://jsonplaceholder.typicode.com/posts/101. Pour cela, utilisez une expression n8n pour récupérer l'ID :
   https://jsonplaceholder.typicode.com/posts/{{ $json.id }}
   Cette expression prend la valeur du champ id du JSON provenant du nœud précédent.
4. Configurez le Body comme à l'étape 1, mais avec un contenu mis à jour. Notez que PUT requiert d'envoyer l'objet complet.

   {
     "id": "{{ $json.id }}",
     "title": "Mon article mis à jour",
     "body": "Le contenu a été modifié via une requête PUT.",
     "userId": 1
   }
   

   Ici aussi, nous injectons dynamiquement l'ID pour être sûr de mettre à jour la bonne ressource.

Exécutez ce nœud. La réponse doit être l'objet mis à jour.

Étape 3 : Supprimer l'article (DELETE)

Le dernier nœud va nettoyer en supprimant l'article créé.

1. Ajoutez un troisième nœud HTTP Request à la suite.
2. Method : DELETE
3. URL : Utilisez la même expression que pour l'étape PUT afin de cibler le bon article :
   https://jsonplaceholder.typicode.com/posts/{{ $json.id }}
4. Une requête DELETE n'a généralement pas besoin d'un Body. Vous pouvez laisser cette option désactivée.

Exécutez ce nœud. Une réponse réussie de JSONPlaceholder pour un DELETE est souvent un objet vide ({}) avec un code de statut HTTP 200, confirmant que la suppression a eu lieu.

Pour voir une démonstration de PUT et DELETE en action, la vidéo suivante est très instructive. Bien qu'elle utilise l'API de Airtable, les principes et la configuration dans n8n sont identiques.

3. Solution de l'Exercice

Conformément à votre demande d'avoir des solutions complètes, voici le code JSON du workflow final. Vous pouvez le copier et le coller directement dans votre éditeur n8n (Ctrl+A pour tout sélectionner dans le canvas, puis Ctrl+V pour coller) pour voir la solution en action et la comparer avec votre propre travail.

{
  "name": "Exercice 4.4 - CRUD",
  "nodes": [
    {
      "parameters": {},
      "id": "764b4491-b3b0-469b-81d6-b47209be3747",
      "name": "Start",
      "type": "n8n-nodes-base.start",
      "typeVersion": 1,
      "position": [
        240,
        300
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://jsonplaceholder.typicode.com/posts",
        "sendBody": true,
        "body": "{\n  \"title\": \"Mon premier article avec n8n\",\n  \"body\": \"Ceci est le contenu de mon article.\",\n  \"userId\": 1\n}",
        "options": {}
      },
      "id": "e00b684a-9e1e-450f-a3eb-8e9a69769363",
      "name": "1. Create Post (POST)",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [
        460,
        300
      ]
    },
    {
      "parameters": {
        "method": "PUT",
        "url": "https://jsonplaceholder.typicode.com/posts/{{ $json.id }}",
        "sendBody": true,
        "body": "{\n  \"id\": \"{{ $json.id }}\",\n  \"title\": \"Mon article mis à jour\",\n  \"body\": \"Le contenu a été modifié via une requête PUT.\",\n  \"userId\": 1\n}",
        "options": {}
      },
      "id": "e421fd40-f1d2-4e4b-a94f-4d6f83ab0b93",
      "name": "2. Update Post (PUT)",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [
        720,
        300
      ]
    },
    {
      "parameters": {
        "method": "DELETE",
        "url": "https://jsonplaceholder.typicode.com/posts/{{ $json.id }}",
        "options": {}
      },
      "id": "31ac7c86-107e-402c-a02b-a0100f983a54",
      "name": "3. Delete Post (DELETE)",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.1,
      "position": [
        960,
        300
      ]
    }
  ],
  "connections": {
    "Start": {
      "main": [
        [
          {
            "node": "1. Create Post (POST)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "1. Create Post (POST)": {
      "main": [
        [
          {
            "node": "2. Update Post (PUT)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "2. Update Post (PUT)": {
      "main": [
        [
          {
            "node": "3. Delete Post (DELETE)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Conclusion

Félicitations ! Vous avez construit un workflow qui non seulement interroge une API, mais qui interagit avec elle pour créer, modifier et supprimer des données. C'est une compétence fondamentale pour automatiser des processus métier complexes.

Points clés à retenir :

• Le cycle CRUD (Create, Read, Update, Delete) est mappé aux méthodes HTTP POST, GET, PUT/PATCH et DELETE.
• Le nœud HTTP Request de n8n permet de changer de méthode très facilement via le menu déroulant Method.
• Le chaînage des opérations est crucial : l'identifiant (id) renvoyé par la requête de création (POST) est indispensable pour cibler la ressource lors des mises à jour (PUT) et des suppressions (DELETE).
• Les expressions n8n (ex: {{ $json.id }}) sont le mécanisme qui permet de passer dynamiquement des données d'un nœud à l'autre.

Dans la prochaine leçon, nous aurons un autre exercice qui mettra à profit vos connaissances du nœud HTTP Request. Nous reviendrons sur le sujet de la leçon précédente pour construire un workflow qui récupère des données paginées et agrège tous les résultats en une seule liste. Cela vous permettra de consolider vos compétences sur la récupération de données à grande échelle.