Logo Xorvian
Xorvian
Retour à tous les guides
DEVELOPER8 min2026-09

Guide Complet du Format JSON, Validation de Schémas & Architecture d'APIs REST

Tout sur la sérialisation JSON (RFC 8259), typage strict, JSON Schema, gestion des dates, minification et communication client-serveur.

JSON (JavaScript Object Notation), formalisé par Douglas Crockford au début des années 2000 et standardisé par la RFC 8259, est le format d'échange de données universel du web moderne. Simple, léger et lisible par l'humain comme par la machine, il a supplanté le XML dans la quasi-totalité des architectures d'API REST et GraphQL.

Ce guide passe en revue la spécification technique, les pièges de sérialisation courants et les techniques de validation automatisée.

1. La Grammaire et les Types de Données Autorisés

La spécification JSON stricte n'autorise que 6 types de données fondamentaux :

• String : Chaîne de caractères UTF-8 impérativement entourée de guillemets doubles (").

• Number : Nombre entier ou à virgule flottante au format décimal standard (sans NaN ni Infinity).

• Boolean : Les constantes littérales minuscules true ou false.

• Null : La valeur d'absence de données null.

• Array : Liste ordonnée d'éléments entre crochets [].

• Object : Ensemble de paires clé-valeur entre accolades {}, où chaque clé doit être une chaîne entre guillemets doubles.

Erreur fréquente : Les virgules traînantes

Contrairement au JavaScript moderne, le standard JSON interdit strictement les virgules finales après le dernier élément d'un objet ou d'un tableau (trailing commas).

2. Les Pièges Classiques de Sérialisation

• Dates : JSON ne possède pas de type Date natif. La norme internationale consiste à sérialiser les horodatages sous forme de chaîne ISO 8601 (ex: '2026-09-13T16:00:00.000Z').

• Nombres de grande taille (BigInt) : Les nombres entiers dépassant Number.MAX_SAFE_INTEGER (2^53 - 1, soit 9 007 199 254 740 991) subissent une perte de précision lors du parsing JSON standard et doivent être transmis sous forme de chaînes de caractères.

• Références circulaires : La méthode JSON.stringify() lève une exception TypeError si un objet contient une référence vers lui-même.

3. Valider ses Payloads avec JSON Schema

Pour sécuriser vos endpoints d'API, l'utilisation de JSON Schema (Draft-07 ou Draft 2020-12) permet de déclarer contractuellement la structure attendue d'un document (propriétés obligatoires, types, regex de format, bornes numériques).

Des validateurs rapides comme Ajv ou Zod permettent d'intercepter les requêtes malformées dès la passerelle d'API avant qu'elles n'atteignent votre logique métier.

Questions Fréquentes

Réponses aux questions courantes sur ce sujet.

Outils Interactifs Liés à ce Guide

Utilisez gratuitement ces outils pour appliquer directement les concepts de ce guide.

Formateur JSON

Formatez et validez du JSON.

Texte
Comparateur de texte

Comparez deux textes ligne à ligne.

Texte
Décodeur Base64

Décodez une chaîne Base64.

Texte
Testeur d'Expressions Régulières (Regex)

Testez, analysez et générez vos regex avec étoile de Kleene et surlignage.

Texte