Mettere JSON nei sistemi reali: come definire i contratti API, come gestire configurazione e fixture, come gestire la compatibilità delle versioni e come mantenere i dati di test.
5 articoliSei cose sono molto difficili da cambiare una volta rilasciate: envelope delle risposte, formati degli errori, forma della paginazione, rappresentazione di ID e tempo, semantica di null versus assenza, ed evoluzione delle versioni.
La configurazione deve essere stratificata e validata; i fixture devono essere deterministici, leggibili e diffabili. Se questi due tipi di file vengono gestiti male, i costi di troubleshooting restano alti a lungo.
Cinquanta record diventano cinquantuno e il diff segnala cinquantuno modifiche. Copre i falsi positivi del diff testuale, il matching degli array per id, la normalizzazione con jq e le patch applicabili.
merge=union lascia passare JSON rotto e riporta comunque successo. Questo percorre un merge driver three-way consapevole delle chiavi per JSON, più tre abitudini che riducono i conflitti.
Aggiungere un campo non è automaticamente sicuro. Copre i confini di compatibilità, i campi versione, le finestre di deprecazione, la migrazione a doppia scrittura, i contract test e le metriche di canary.
