Klíčové body návrhu datových kontraktů JSON API
Šest věcí se po nasazení mění velmi těžko: obálky odpovědí, formáty chyb, tvar stránkování, reprezentace ID a času, sémantika null versus chybějící pole a vývoj verzí.
Nasazení JSON do skutečných systémů: jak definovat smlouvy API, jak spravovat konfiguraci a fixtures, jak řešit kompatibilitu verzí a jak udržovat testovací data.
5 článkůŠest věcí se po nasazení mění velmi těžko: obálky odpovědí, formáty chyb, tvar stránkování, reprezentace ID a času, sémantika null versus chybějící pole a vývoj verzí.
Konfigurace musí být vrstvená a validovaná; fixtures musí být deterministické, čitelné a diffovatelné. Pokud se tyto dva druhy souborů spravují špatně, náklady na diagnostiku zůstávají dlouho vysoké.
Padesát záznamů se stane padesáti jedna a diff hlásí padesát jedna změn. Pokrývá falešné poplachy textového diffu, párování polí podle id, normalizaci v jq a aplikovatelné patche.
merge=union propustí neplatný JSON a přesto hlásí úspěch. Procházíme merge driver pro JSON se znalostí klíčů a tři návyky, které konflikty sníží.
Přidání pole není automaticky bezpečné. Pokrývá hranice kompatibility, verze v dokumentu, deprecation windows, migraci s dvojím zápisem, kontraktní testy a canary metriky.