Полевой гид для инженеров, принимающих JSON от других систем и которых он может поджечь.

ПРАВИЛО: вердикт валидатора должен быть свойством документа, а не обёртки, которая его перенесла. Если validate(body) и validate({"data": body}) могут расходиться, вы валидируете транспорты, и вы ощутите последствия в день, когда клиент передумает об обёртке.

ЧТО В КНИГЕ: пять способов, которыми обёртка меняет вердикт — дубликаты ключей, UTF-8 BOM, который выживает после fix через lstrip(), несоответствие канонического дайджеста, рекламируемый список кодов ошибок, который не совпадает с возвращаемым, и область catch, возвращающая валидное потому что парсер бросил исключение. Каждому — проверка, которая закрывает её.

ПОЧЕМУ ЭТО СТОИТ ПОКУПАТЬ: дефектный класс измеряется, а не подразумевается. По реальной реализации 9 из 13 тестовых полезных данных давали РАЗЛИЧНЫЕ вердикты между двумя обёртками, 7 из них были неверно сформированными документами, принятыми как валидные в одной и отклонёнными в другой. Прогон холостого теста мог бы охватить все семь. Случай BOM — тот, который возвращается после своего исправления, на один байт уже узкий.

ЧТО ВЫ ПОЛУЧИТЕ: письменный гид, двенадцатидоковый корпус, который он описывает как запускаемый тест-файл, инфраструктура-обёртка-неизменяемости (один аре́кса́тор, менее секунды) и каноническая схема повторной сериализации для сравнения дайджеста. Работает офлайн, без аккаунта, без сети, без ключей.

Лицензия: коммерческая.