Справочник

Запросы к API

Блоки «Запрос к API ВКонтакте» и «Запрос к API MAX» вызывают произвольный метод сети прямо из программы. Отдельный блок «Комментарий к записи ВКонтакте» решает частую задачу — оставить комментарий, не собирая вызов вручную. Ответ сохраняется в память прохода и доступен следующим блокам.

Запрос к API ВКонтакте

Укажите метод VK API (например users.get) и при необходимости добавьте параметры (имя/значение). Токен подставляется автоматически из интеграции ВКонтакте. Ответ ложится в {b.<номер>.value…}.

Запрос к API MAX

Укажите путь метода Bot API MAX (например me, chats), query-параметры и, при необходимости, тело запроса (JSON). Если тело заполнено — запрос уходит методом POST, иначе GET. Токен подставляется из интеграции MAX.

Комментарий к записи ВКонтакте

Добавляет комментарий к записи на стене — метод wall.createComment. Поля блока:

Блок работает только при наличии интеграции ВКонтакте, у которой есть право wall. Если права нет, ВКонтакте вернёт ошибку «нет доступа к методу» — она попадёт в {b.<номер>.error}.

ID добавленного комментария доступен следующим блокам как {b.<номер>.value.comment_id}. Например, его можно сохранить в ресурс или отправить пользователю ссылку на свой комментарий.

Параметры и переменные

В значениях параметров и в теле запроса работают переменные шаблонизатора: {from_id}, {b.0.text}, {b.<номер>.value…} и прочие. Так можно подставить в запрос данные пользователя или ответ предыдущего блока.

Чтение ответа

Ответ метода доступен следующим блокам: {b.<номер>.value…} — данные, {b.<номер>.ok} — успех, {b.<номер>.error} — ошибка. Например, после users.get имя пользователя — {b.<номер>.value.0.first_name}. <номер> — номер блока запроса.

Какая интеграция используется

Блок сам выбирает интеграцию: закреплённую за ним, иначе активную по типу триггера, иначе любую активную интеграцию нужной сети в кабинете. Если подходящей интеграции или токена нет — блок вернёт ошибку в {b.<номер>.error} и программа пойдёт дальше.