Функции этой группы помогают разобрать ответ внешнего запроса: достать нужное значение из JSON или, наоборот, собрать JSON для отправки. Строку с JSON можно передавать в функции напрямую.

Где пригодится:

  • достать цену, статус заказа или ссылку из ответа API;
  • получить список ключей, чтобы понять, что пришло в ответе;
  • подготовить данные подписчика для отправки во внешний сервис.

Функции

ФункцияОписаниеПример
json_parse(text)Превращает строку с JSON в данные, с которыми можно работать функциями этого раздела.data = json_parse(client.ответ_api)
json_get(json, путь, default)Достаёт значение из JSON по пути через точку. Номер элемента списка указывается цифрой, нумерация с 0. Если значения нет, возвращает default (по умолчанию — пустое значение).json_get(client.ответ_api, 'items.0.price') → 1990
get(collection, key, default)Возвращает элемент списка по номеру (нумерация с 0) или значение словаря по ключу. Если элемента нет, возвращает default (по умолчанию — пустое значение). Строку с JSON можно передать напрямую. В отличие от json_get, берёт значение только одного уровня, без пути через точку.get('["курс", "книга"]', 1) → "книга"
get('{"a": 1}', "b", 0) → 0
to_json(value)Превращает список или словарь в строку JSON — например, чтобы сохранить в поле или отправить во внешнем запросе.to_json(["курс", "книга"]) → '["курс", "книга"]'
dict_keys(dict)Возвращает список ключей словаря. Строку с JSON можно передать напрямую.dict_keys('{"a": 1, "b": 2}') → ["a", "b"]
dict_values(dict)Возвращает список значений словаря. Строку с JSON можно передать напрямую.dict_values('{"a": 1, "b": 2}') → [1, 2]

Пример: цена и статус из ответа API

Допустим, ответ внешнего запроса сохранён в поле ответ_api:

{"items": [{"name": "Курс", "price": 1990}], "status": "ok"}

Достаём данные в шаге «Формула»:

client.price = json_get(client.ответ_api, "items.0.price")
client.status = get(client.ответ_api, "status")
client.keys = join(dict_keys(client.ответ_api), ", ")

Результат: price — 1990, status — ok, keys — items, status.

json_get проходит по пути через точку на любую глубину, а get берёт значение только первого уровня. Если значения нет, обе функции вернут пустое значение или то, что передано третьим аргументом.

Пример: собрать JSON для отправки

Подписчик перечислил интересы через запятую. Превратим их в JSON-список, чтобы передать во внешний запрос.

client.interests_json = to_json(split_list(client.interests, ", "))

Если подписчик написал йога, бег, в interests_json запишется ["йога", "бег"].

Добавить, удалить или найти элемент в списке — в статье Формула: списки.


Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно

Зарегистрируйтесь в BotHelp

14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.

Создать аккаунт

Была ли статья полезна?

Наши каналыTelegramMAX
Спасибо за обратную связь!