Le problème

L’API publique d’un transporteur renvoie "weight": "12.5 kg". Les nouvelles balances de l’entrepôt pèsent au gramme près, et certains clients expédient en livres. L’équipe veut "weight": { "value": 12.5, "unit": "kg" }.

2 000 intégrations clientes lisent ce champ aujourd’hui. L’une d’elles est le script Node.js d’une petite boutique, qui appelle parseFloat(shipment.weight). Sur "12.5 kg", il obtient 12.5. Sur un objet, parseFloat le convertit d’abord en chaîne [object Object] et renvoie NaN, et l’imprimante d’étiquettes s’arrête.

Personne chez le transporteur ne peut corriger ce script. Le changement doit sortir quand même, sans casser une seule intégration.