JSON: что это
JSON — компактный текстовый формат, в котором программы передают друг другу данные: пары «ключ: значение», списки и вложенные объекты. Ответы API лидогенерации приходят именно в нём.
Определение
JSON записывает данные в фигурных скобках как набор пар «ключ: значение». Значения бывают строками в кавычках, числами, true/false, null, списками в квадратных скобках и вложенными объектами. Его читает и человек, и любой язык программирования.
Пример из лидогенерации
Успешный ответ на приём заявки выглядит так: { "status": "ok", "lead_id": 443110 }. Отказ: { "status": "error", "code": "limit_reached", "message": "…" }. Ваша система читает поле status и решает, что делать дальше.
Частые ошибки
- Одинарные кавычки вместо двойных: строгий JSON их не принимает.
- Запятая после последнего элемента.
- Неэкранированные кавычки внутри текста, например в имени или поле «info».
- Телефон как число: ведущие символы и плюс теряются. Телефон лучше передавать строкой.
Нюансы
Кодировка текста — UTF-8. Если кириллица превращается в «кракозябры», проверьте её на обеих сторонах. Для отладки используйте форматтеры, они подсвечивают место синтаксической ошибки.
Практический совет
Для проверки пользуйтесь валидаторами: вставьте тело запроса и убедитесь, что оно разбирается без ошибок. Это занимает несколько секунд и избавляет от долгой отладки на стороне трекера.
Связанные понятия
JSON — язык, на котором общаются API и вебхуки. Его отправляют POST-запросом и читают по коду ответа. Описание ответов собрано в разделе API.
Вопросы и ответы
JSON и XML — в чём разница?
Оба формата передают структурированные данные. JSON короче и проще читается, поэтому в современных интеграциях встречается чаще.
Можно ли в JSON передавать комментарии?
Нет, стандарт их не допускает. Пояснения храните в документации.