Парсинг JSON в BAS

Когда данные приходят как JSON, а не как отрисованная страница - от API, XHR-вызова или HTTP-клиента - правильный инструмент не XPath, а модуль «JSON». Он читает и преобразует JSON через JSONPath, JSON-аналог XPath-запроса.

Для чего он

Модуль «JSON» работает с JSON-данными через выражения JSONPath. Где XPath адресует элементы в HTML, JSONPath адресует значения в JSON-документе - вы пишете путь к нужному полю, и модуль его возвращает. Так вы чисто вытаскиваете структурированные данные из ответов API и HTTP-клиента.

Действия

Чтение.

• Получить значение - вернуть одно значение по JSONPath.
• Получить все значения - вернуть все значения по пути.
• Получить срез - прочитать массив или его часть.
• Количество элементов - сколько элементов в массиве.

Изменение.

• Изменить значение - задать значение по пути.
• Удалить значение - убрать значение.
• Изменить формат - переформатировать JSON.

Валидация.

• Подходит ли под JSONPath - проверить, разрешается ли путь, прежде чем на него полагаться.

Где он в картине

Парсинг JSON - естественный напарник HTTP-клиента. Частый паттерн: отправить запрос к API, получить тело JSON, затем действиями Получить значение и Получить все значения с JSONPath извлечь нужные поля - куда быстрее и чище, чем скрапить отрисованную страницу. Используйте XPath для HTML, JSON для API - и вы покрыли оба пути, которыми структурированные данные доходят до бота.