JSON — компактный текстовый формат обмена данными. Его используют веб-приложения, мобильные программы, API, конфигурационные файлы и серверные службы. Если понимать несколько базовых правил, читать JSON и находить ошибки в нём становится намного проще.
Практический совет: проверяйте JSON после каждого существенного изменения, особенно если файл формируется автоматически. Для быстрой проверки можно вставить данные в JSON-валидатор DimLife; перед отправкой удаляйте из примеров токены, пароли и персональные данные.
Из чего состоит JSON
В JSON есть объекты, массивы и значения нескольких типов. Объект записывается в фигурных скобках и содержит пары «ключ — значение». Массив находится в квадратных скобках и хранит упорядоченный список значений.
{
"name": "DimLife",
"active": true,
"users": 12,
"tags": ["tools", "irc"],
"description": null
}
В примере строковые ключи заключены в двойные кавычки. Значениями могут быть строки, числа, true, false, null, объекты и массивы.
Основные правила синтаксиса
- Имена свойств обязательно заключаются в двойные кавычки.
- Между ключом и значением ставится двоеточие.
- Элементы разделяются запятыми.
- В конце последнего элемента объекта или массива запятая не ставится.
- Строки используют двойные кавычки, а специальные символы экранируются обратной косой чертой.
- Комментарии в стандартном JSON не поддерживаются.
Частые ошибки JSON
Одинарные кавычки
Запись {‘name’: ‘DimLife’} похожа на JSON, но не соответствует стандартному синтаксису. Нужно использовать двойные кавычки.
Лишняя запятая
Запятая после последнего элемента объекта или массива часто вызывает ошибку разбора. Удалите её.
Незакрытая скобка или строка
Проверьте, что каждая открывающая фигурная или квадратная скобка имеет закрывающую пару, а каждая строка завершается кавычкой.
Число вместо строки и наоборот
Значения 123 и «123» — разные типы. API может ожидать число, но получить строку, или наоборот. Синтаксически оба варианта допустимы, но структура может не соответствовать требованиям сервиса.
Синтаксис и схема — разные проверки
Если JSON успешно разбирается, это означает только то, что его синтаксис корректен. Это не гарантирует, что сервер примет данные. Например, API может требовать обязательное поле id, ограничивать допустимые значения status или ожидать массив вместо строки. Такие правила проверяются отдельно — по документации API или JSON Schema.
Как быстро проверить JSON
- Скопируйте данные из файла или ответа API.
- Откройте JSON-инструмент DimLife.
- Вставьте содержимое и запустите проверку или форматирование.
- Если есть ошибка, проверьте указанную позицию, кавычки, запятые и скобки.
- После исправления проверьте не только синтаксис, но и соответствие ожидаемой структуре.
Не вставляйте секреты в публичные проверяющие сервисы
Ответы API могут содержать токены доступа, персональные данные, адреса электронной почты и внутренние настройки. Перед использованием онлайн-инструмента удалите секретные значения. Для конфиденциальных файлов выбирайте локальную проверку на своём устройстве.
Итог
JSON прост, если соблюдать строгие правила: двойные кавычки, правильные разделители, корректные скобки и допустимые типы. А для реальной интеграции всегда проверяйте не только синтаксис, но и структуру данных, которую ожидает принимающая система.

