HTTP

Интеграция HTTP отправляет веб-запросы из Macro Deck. С её помощью можно вызвать вебхук, управлять устройством в вашей сети, у которого есть веб-API, или считать значение из онлайн-сервиса и показать его на кнопке. Она входит в Macro Deck и включена с самого начала, поэтому ни к чему подключаться и никуда входить не нужно.

Два действия

Отправить HTTP-запрос собирает полноценный запрос. Вы выбираете Метод, вводите URL и добавляете Параметры запроса и Заголовки в виде пар «имя и значение». В поле Тип тела выбирается none, json, form, text или multipart (загрузка файла с дополнительными полями формы). Аутентификация предлагает basic (имя пользователя и пароль), bearer (токен) и header (токен в заголовке с заданным именем, например X-Api-Key). Ожидаемый статус определяет, какие ответы считаются успешными, по умолчанию 2xx. Также можно задать Тайм-аут, выключить параметр Следовать перенаправлениям и ограничить Максимальный размер ответа (байт).

Поле Захват сохраняет части ответа в переменные. Каждая строка связывает имя переменной с селектором: $status, $ok, $duration, $body, $truncated, $headers, $header:<name> или путь JSON, например data.items[0].name. Переменная, которой ещё нет, создаётся.

Действие Получить значение JSON служит коротким способом считать одно значение: введите URL, Путь JSON и переменную в поле Сохранить в переменную.

Примеры

• Кнопка, которая отправляет {"text": "Stream is live"} в вебхук чата с помощью действия Отправить HTTP-запрос с типом тела json.
• Кнопка, которая включает умную розетку в вашей сети через её локальный веб-API.
• Кнопка, которая считывает текущую цену из публичного API с помощью действия Получить значение JSON и показывает её в подписи через {{ vars.price }}.
• Цепочка действий, которая отправляет запрос, захватывает $status и с помощью Если / Иначе окрашивает кнопку в красный, если сервер ответил не 200.

Значения параметров запроса и заголовков могут содержать переменные, например {{ vars.channel }}. Запрос выполняется на компьютере, где работает Macro Deck, поэтому адреса вроде http://192.168.1.20 достигают устройств в сети этого компьютера. Действие завершается с понятным сообщением, если сервер недоступен, время запроса истекло, сертификат TLS отклонён или статус не тот, который вы ожидали.