Лидпульт

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 передавать комментарии?

Нет, стандарт их не допускает. Пояснения храните в документации.