Парсинг 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 — и вы покрыли оба пути, которыми структурированные данные доходят до бота.