Lisez et exploitez le format JSON

Vous savez maintenant décomposer un appel API, lire une documentation et interpréter un code de statut. Mais il reste une question concrète : quand l'API de Storra vous répond, elle vous envoie quoi exactement ? Un tableau Excel ? Un fichier Word ? Non : elle vous envoie du JSON.

C'est le format que vous allez manipuler dans absolument tous vos projets no-code. Comprendre sa structure, c'est la dernière pièce du puzzle avant de pouvoir faire circuler des données entre vos outils.

Découvrez la structure du format JSON

Revenons à Storra. Vous venez de configurer votre premier appel GET sur l'endpoint/orders. Le code de statut retourné est 200 : succès. Mais dans n8n, vous voyez s'afficher une longue suite de texte que vous n'avez jamais vu auparavant. C'est ça, une réponse JSON.

JSON signifie JavaScript Object Notation. C'est un format texte léger, lisible par un humain et compréhensible par toutes les machines. C'est pourquoi il est devenu le standard universel d'échange entre APIs.

Sa structure repose sur deux éléments de base.

Un objet JSON est une collection de paires clé/valeur, encadrée par des accolades. Voici un exemple simple — une commande Storra :

{
  "id": "1042",
  "status": "pending",
  "total": 59.90,
  "customer": "Amara Diallo"
}

Chaque ligne est une paire clé/valeur : la clé est toujours entre guillemets ("status"), la valeur peut être un texte (string), un nombre (number), un booléen (trueoufalse), ounull(absence de valeur).

Un tableau JSON regroupe plusieurs objets entre crochets. C'est ce que vous recevez quand vous interrogez une liste — plusieurs commandes, plusieurs produits :

[
  {
    "id": "1042",
    "status": "pending",
    "total": 59.90
  },
  {
    "id": "1043",
    "status": "shipped",
    "total": 120.00
  }
]

Les objets peuvent aussi être imbriqués les uns dans les autres. Un produit Storra avec ses détails pourrait ressembler à ceci :

{
  "id": "P88",
  "title": "Tote bag Storra",
  "category": "Accessoires",
  "description": "Tote bag en coton recyclé, sérigraphié.",
  "price": 24.90
}

Lisez et analysez une réponse JSON

Recevoir une réponse JSON, c'est bien. Savoir la lire rapidement pour en extraire ce dont vous avez besoin, c'est mieux. Voici une méthode en 3 étapes que j'applique systématiquement sur le terrain.

Prenons une réponse réaliste de l'API Storra sur l'endpointGET /orders:

{
  "id": "1042",
  "status": "pending",
  "total": 59.90,
  "created_at": "2026-05-31T09:42:00Z",
  "customer": {
    "name": "Amara Diallo",
    "email": "amara.diallo@email.com",
    "phone": "+33612345678"
  },
  "items": [
    {
      "product_id": "ST-BAG-01",
      "product": "Tote bag Storra",
      "quantity": 2,
      "unit_price": 24.90
    }
  ],
  "metadata": {
    "source": "Typeform",
    "payment_method": "Stripe"
  }
}

1. Étape 1 : identifier le niveau supérieur. La réponse commence-t-elle par[ou par{? Ici, elle commence par[: c'est un tableau. Il peut donc contenir plusieurs commandes. Si vous ne voyez qu'un objet{}, vous avez affaire à une ressource unique.

2. Étape 2 : repérer les clés utiles pour le projet. Parcourez les clés disponibles et identifiez celles qui correspondent à un besoin métier. Pour Storra, les clés pertinentes sontstatus(pour filtrer les commandes en attente),total(pour le suivi financier) etcustomer.email(pour déclencher un email Mailchimp).

3. Étape 3 : noter le chemin d'accès. Quand une valeur est imbriquée dans un sous-objet, vous accédez à elle via un chemin. L'email du client n'est pas à la racine de l'objet — il est danscustomer. Son chemin d'accès est donccustomer.email. Dans n8n, c'est exactement la notation que vous utiliserez pour extraire cette valeur.

Ça arrive. Une commande peut ne pas avoir d'email renseigné — la valeur sera alorsnull. Anticipez toujours ce cas dans votre workflow : un champnullnon géré peut faire planter une automatisation entière.

Mappez vos données JSON dans n8n

Vous savez maintenant lire une réponse JSON. Voyons comment exploiter ces données dans n8n afin de les transmettre à une application de destination.

Une fois les données récupérées depuis l'API Storra, l'étape suivante consiste à sélectionner les informations utiles et à les associer aux champs correspondants de votre outil cible. C'est ce que l'on appelle le mapping des données. Dans n8n, cette opération permet de relier chaque champ de la réponse JSON à un champ d'une application comme Google Sheets ou Airtable.

Dans le screencast suivant, vous allez voir comment explorer la structure d'une réponse JSON, identifier les champs pertinents et configurer leur mapping dans n8n afin d'automatiser efficacement le transfert de données.

Vous avez vu comment accéder aux données retournées par l'API Storra, sélectionner les informations utiles et les associer aux champs d'une application de destination. Cette étape est essentielle pour garantir que les données sont correctement exploitées dans vos automatisations.

Voyons maintenant plus en détail comment fonctionne le mapping dans n8n et comment relier chaque champ JSON à son équivalent dans votre outil cible.

Concrètement, pour envoyer les données d'une commande Storra vers Airtable, vous relieriez :

• id→ colonne ID commande dans Airtable ;

• status→ colonne Statut ;

• customer.email→ colonne Email client ;

• total→ colonne Montant.

Quelques bonnes pratiques à adopter dès maintenant :

• Nommez vos champs clairement dans la destination :email_clientest plus lisible queval_3.

• Notez les chemins d'accès dans un document de référence : quand vous reviendrez sur ce workflow dans six mois, vous gagnerez un temps précieux.

• Anticipez les valeurs nulles : dans n8n, vous pouvez définir une valeur par défaut si un champ est absent.

À vous de jouer !

Vous avancez sur votre mission chez Storra. Vous avez cartographié les connexions API, décomposé vos premières requêtes et obtenu vos premiers codes 200. Maintenant, les données arrivent dans n8n. Il faut les lire, les comprendre et les router vers les bons outils.

Voici la réponse JSON que vous venez de recevoir suite à un appelGET /orders?status=pendingsur l'API Storra :

[
  {
    "id": "1042",
    "status": "pending",
    "total": 59.90,
    "customer": {
      "name": "Amara Diallo",
      "email": "amara.diallo@email.com"
    },
    "items": [
      {
        "product": "Tote bag Storra",
        "quantity": 2,
        "unit_price": 24.90
      }
    ]
  },
  {
    "id": "1043",
    "status": "pending",
    "total": 34.00,
    "customer": {
      "name": "Léo Ferreira",
      "email": null
    },
    "items": [
      {
        "product": "Carnet de notes",
        "quantity": 2,
        "unit_price": 17.00
      }
    ]
  }
]

Consignes

1. Identifiez la structure globale de cette réponse : s'agit-il d'un objet ou d'un tableau ? Combien de commandes contient-elle ?

2. Pour chaque commande, relevez les données utiles au projet Storra : l'identifiant, le statut, le montant total, le nom du client, son email et le produit commandé. Notez le chemin d'accès exact pour chaque valeur.

3. La commande 1043 présente une valeurnullsur un champ. Lequel ? Quel problème cela peut-il poser dans votre workflow, et comment l'anticiper ?

4. Proposez un mapping vers Airtable : pour chaque donnée utile identifiée, indiquez le nom de colonne que vous utiliseriez dans la base Airtable de Storra.

En résumé

• JSON est le format standard d'échange entre APIs : léger, lisible, universel. Tout ce qu'une API vous renvoie sera dans ce format.

• Un objet JSON est une collection de paires clé/valeur entre accolades ; un tableau regroupe plusieurs objets entre crochets.

• Lire une réponse JSON, c'est identifier la structure globale, repérer les clés utiles et noter leur chemin d'accès exact (ex.customer.email).

• Dans n8n, le mapping relie chaque champ JSON à une colonne de destination : c'est l'opération concrète qui fait circuler les données entre vos outils.

• Anticiper les valeursnullet documenter les chemins d'accès sont deux réflexes essentiels pour construire des workflows fiables.

Vous savez maintenant lire et exploiter une réponse JSON. Vous avez tous les fondamentaux pour comprendre ce qui circule entre vos outils. Dans la prochaine partie du cours, vous allez passer à la vitesse supérieure : construire des workflows complets dans n8n, enchaîner les appels API et automatiser les premiers flux de Storra de bout en bout.