Функции этой группы помогают разобрать ответ внешнего запроса: достать нужное значение из 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.
Зарегистрируйтесь в BotHelp
14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.
Создать аккаунт