JSON

Что это значит

JSON, то есть JavaScript Object Notation, - простой текстовый формат для записи структурированных данных. Данные записываются как пары «имя - значение» в фигурных скобках, а списки - в квадратных, поэтому файл может прочитать и человек, и программа без сложной обработки.

Формат знает лишь несколько типов значений: текст, число, логическое значение, пустое значение, объект и массив. Эта простота сделала его стандартом обмена данными между приложениями, особенно через API и REST API, где он в основном вытеснил более старый XML.

Хотя название отсылает к JavaScript, JSON не зависит от языка программирования, и с ним работают почти все языки и базы данных. Он используется в конфигурационных файлах, хранении настроек, экспорте из приложений и в вебхуках, которые присылают уведомления о событиях.

Как это работает на практике

Для сайтов важен JSON-LD - способ записи структурированных данных по словарю Schema.org. В страницу вставляют блок, который сообщает поисковикам, что это компания, статья, вопросы и ответы или определение термина, и это может улучшить вид в результатах поиска.

В бухгалтерии JSON встречается при связывании систем. Банки в рамках открытого банкинга, платёжные шлюзы, интернет-магазины и инструменты iPaaS передают транзакции и заказы именно в этом формате, а учётная программа загружает их как документы по согласованной структуре.

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

На что обратить внимание

JSON не задаёт формат дат и чисел. Одна система пришлёт дату текстом в виде год-месяц-день, другая - числом секунд, а суммы могут прийти дробными числами с ошибкой округления. Для финансовых данных надёжнее передавать суммы в центах или текстом с фиксированным числом знаков после запятой.

Файлы JSON часто содержат персональные данные или ключи доступа, например API-ключи в конфигурации. Их нельзя хранить в публичных репозиториях или отправлять почтой без защиты, а журналы с полными телами запросов нужно защищать так же, как саму базу данных.