⬜ Décoder du JSON

Le bloc Décoder du JSON permet de transformer des données au format texte JSON (souvent issues d'API ou de Webhooks) en variables individuelles exploitables dans les autres blocs Celestory (Texte, Nombre, Booléen, Liste, etc.).

Ce bloc est particulièrement utile pour extraire des informations structurées depuis des réponses d'API ou des données externes, et les rendre accessibles sous forme de sorties typées.

📥 Entrées

• json (Texte) : Le texte au format JSON à décoder. Ce contenu doit correspondre à la structure définie dans le schéma.
• schéma (Texte) : Un exemple de JSON servant de modèle pour générer les sorties. Exemple : {"nom": "Jean", "age": 30} créera automatiquement les sorties nom et age.

📤 Sorties

• out (Flux) : Le flux de sortie qui s'active une fois le décodage effectué.
• [Clés du schéma] (Variable) : Pour chaque clé présente dans le schéma, une sortie correspondante est générée avec le type approprié (Texte, Nombre, Booléen, ou Liste).

💡 Exemple d'utilisation

Scénario : Récupérer les informations d'un utilisateur depuis une API

1. Un bloc Requête API interroge un service externe pour obtenir les données d'un utilisateur au format JSON.
2. Le résultat de l'API est stocké dans une variable reponseApi contenant {"nom": "Alice", "age": 28, "estAbonne": true}.
3. Le bloc Décoder du JSON est configuré avec :

• json : reponseApi
• schéma : {"nom": "Exemple", "age": 0, "estAbonne": false}

4. Le bloc génère automatiquement les sorties nom (Texte), age (Nombre) et estAbonne (Booléen).
5. Les sorties sont reliées à un bloc Afficher un message pour afficher : "L'utilisateur Alice a 28 ans et est abonné : true".

⚙️ Détails Techniques

• Génération dynamique des sorties : Les sorties sont créées automatiquement en fonction du schéma fourni. Leur type est déduit de la valeur exemple (ex: "texte" → Texte, 42 → Nombre, true → Booléen).
• Validation du JSON : Si le JSON d'entrée ne correspond pas au schéma, les sorties générées retourneront des valeurs par défaut (ex: null pour les objets, 0 pour les nombres).
• Gestion des erreurs : En cas d'erreur de décodage (JSON invalide), le flux out n'est pas activé. Utilisez un bloc Gérer l'erreur pour capturer ce cas.

Mis à jour le : 04/03/2026