JSON: что это простыми словами
Сайт отправляет заявку в CRM, CRM — данные в учётную систему, сервис доставки — статус посылки. Почти всегда эти данные упакованы в JSON — текстовый формат, который одинаково понимают люди и программы. Разбираем, что такое JSON, из чего он состоит, как читать ответ API и какие ошибки ломают файл, — и даём шпаргалку в Word.
Что такое JSON
JSON (JavaScript Object Notation) — текстовый формат обмена данными. Он описан в стандарте RFC 8259 (декабрь 2017 года) и не привязан к языку программирования: его читают и пишут почти все языки и сервисы. Большинство API — в том числе API amoCRM — принимают и отдают данные именно в JSON.
Файл с расширением .json — обычный текстовый файл: его можно открыть блокнотом, браузером или редактором кода. Между независимыми системами, по стандарту, JSON передаётся в кодировке UTF-8.
Из чего состоит JSON
По стандарту в JSON четыре простых типа — строки, числа, логические значения и null — и два составных: объекты и массивы.
Объект — неупорядоченный набор пар «имя — значение», где имя — строка; массив — упорядоченный список значений. Внутри объекта может лежать другой объект или массив — так описывают сделку с контактом и списком тегов.
Пример: сделка в JSON
Шпаргалка: типы, пример сделки и частые ошибки
В примере у сделки номер 1024 — число, название — строка, сумма 45000 — число, признак «закрыта» — false, теги — массив строк, контакт — вложенный объект с именем и телефоном, комментарий — null. Программа, которая получает такой JSON, точно знает, где сумма и где телефон.
Частые ошибки
Одинарные кавычки
{'name': 'Анна'} — неверно; строки и ключи — только в двойных кавычках
Ключ без кавычек
{name: "Анна"} — так можно в коде, но не в JSON
Запятая после последнего элемента
по стандарту запятая ставится только между элементами
Комментарии
в грамматике JSON комментариев нет — пояснения пишут в документации
Дробь через запятую
45000,50 — это два числа; дробная часть — через точку
Если сервис отвечает ошибкой разбора, первым делом проверьте JSON в любом валидаторе: он покажет строку с ошибкой.
Как читать ответ API
Ответ API — это JSON, где нужное лежит на нескольких уровнях вложенности: ответ → список записей → запись → поле. Двигайтесь по ключам сверху вниз. Если в ответе есть номер страницы и ссылки на следующую, значит, записи отдаются частями и за остальными нужен ещё запрос.
Как устроены запросы и ответы, ключи доступа и лимиты — в статьях «Что такое API», «API-ключ» и «API amoCRM».
Шпаргалка по JSON в Word
Четыре раздела: типы значений с примерами, пример сделки, частые ошибки «неверно — верно» и как читать ответ API. Удобно держать рядом, когда настраиваете вебхук или смотрите, что пришло от сервиса.
Скачать шпаргалку по JSON · docx, 10 КБ
Интеграции amoCRM по API
Мы ведём разработку по API для amoCRM: связываем CRM с сайтом, учётной системой, складом и сервисами, разбираем их JSON и следим, чтобы обмен не ломался. Работаем по часам: 4 000 ₽ в час, вилку называем до начала работы; скидка возможна — индивидуально, в зависимости от объёма работ.
JSON — текстовый формат обмена данными (RFC 8259): строки, числа, true/false, null, объекты и массивы. Строки и ключи — в двойных кавычках, дробь — через точку, запятая — только между элементами, комментариев нет. Ответ API читают по ключам сверху вниз, а ошибку разбора находят валидатором.
Частые вопросы
Converssion CRM — официальный партнёр amoCRM с 2017 года. Внедряем и сопровождаем amoCRM, делаем собственные виджеты для амоМаркета, чат-ботов, ИИ-агентов, сайты и рекламу. Услуги · Кейсы клиентов · Виджеты
