Возможности сервера

HTTP API Blynk Legacy

HTTP API сервера Blynk Legacy: https://api.blynk.aravix.ru. Авторизация — персональным Auth Token устройства.

Все примеры ниже содержат вымышленный Auth Token 0123456789abcdef0123456789abcdef. Перед проверкой замените его целиком на токен своего устройства, а пин — на используемый в вашей прошивке. Сам по себе пример с вымышленным токеном не работает.

Адреса API

Адрес	Назначение
`https://api.blynk.aravix.ru`	Стандартный Legacy API.
`https://kuzya.blynk.aravix.ru`	Тот же API с адаптацией формата чтения `/get` для Кузи.

Статус устройства

Как проверить: скопируйте адрес из блока ниже, замените вымышленный токен своим и откройте его в браузере. Ответ true означает, что устройство подключено, false — не подключено.

Браузер · GET /isHardwareConnected

https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/isHardwareConnected

Ответ: true или false.

Чтение виртуального пина

Как проверить: подставьте свой токен и нужный виртуальный пин, затем откройте адрес в браузере. Ответ покажет значение, сохранённое на сервере Blynk.

Браузер · GET /get/V3

https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/get/V3

Например, при числовом значении ответ может быть ["22.875"]. Базовый API возвращает массив значений. Если устройство отключено, значение может оказаться последним сохранённым; сначала проверьте статус подключения.

Проверка адаптера Кузи: этот адрес тоже открывается в браузере. Для числового значения вместо массива Blynk вы увидите объект с полем value.

Браузер · GET через адаптер Кузи

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/get/V3

Для одного числового значения адаптер возвращает {"value":22.875}. Адаптация производится для маршрутов чтения виртуальных, цифровых и аналоговых пинов; остальные запросы передаются без изменения формата.

Запись значения

Проверка через браузер: откройте адрес после замены токена, пина и значения на свои. Осторожно: это уже управляющий запрос; он может включить или выключить реальное оборудование. Не проверяйте его на неизвестных пинах.

Браузер · GET /update/V21

https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21?value=1
https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21?value=0

Если сервер принял запрос, это ещё не доказывает выполнение команды устройством. При наличии обратной связи проверьте фактическое состояние оборудования.

Управление реле зависит от логики прошивки: в этом примере 1 — включить, 0 — выключить.

Для Кузи допустимы те же маршруты через kuzya.blynk.aravix.ru. Значения 1 и 0 подходят только тем прошивкам, где именно они означают включение и выключение.

Запись методом PUT

Метод PUT поддерживается сервером Aravix. Практическая проверка подтвердила передачу значения подключённому устройству и успешную обработку команды. Полное тестирование всех сценариев не проводилось.

Как проверить: откройте Windows PowerShell, вставьте команду целиком и нажмите Enter. Предварительно замените токен, пин и значение на свои. Выбирайте только безопасный для записи пин.

PowerShell · PUT (вымышленный токен)

Invoke-WebRequest -UseBasicParsing -Method PUT -Uri "https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21" -ContentType "application/json" -Body '["1"]' | Select-Object StatusCode, Content

В ответе ожидается HTTP 200, если запрос принят сервером. Для проверки выполнения необходимо также посмотреть результат на устройстве или в приложении Blynk. Практически подтверждён один сценарий передачи и обработки команды; полной проверки всех сценариев не проводилось.

Замените вымышленный токен, виртуальный пин и передаваемое значение на свои. Отправляйте команду только на пин, назначение которого известно: запись может вызвать действие оборудования.

Отправка уведомления

Уведомление в Telegram через Blynk Notify отправляется методом POST с JSON-телом body.

Этот блок показывает структуру HTTP-запроса для разработчиков. Его нельзя целиком вставить в адресную строку браузера. Для самостоятельной проверки на Windows воспользуйтесь готовой командой PowerShell ниже.

Формат HTTP-запроса · POST /notify

POST https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/notify
Content-Type: application/json

{"body":"Температура выше 35 градусов"}

PowerShell · отправить тестовое уведомление (вымышленный токен)

$json = '{"body":"Тестовое уведомление через API"}'
Invoke-WebRequest -UseBasicParsing `
  -Method POST `
  -Uri "https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/notify" `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($json)) |
  Select-Object StatusCode, Content

Как проверить: откройте Windows PowerShell, замените вымышленный токен в команде своим и выполните весь блок. При успешном HTTP-запросе проверьте, пришло ли сообщение в Telegram через Blynk Notify. Для доставки аккаунт Blynk должен быть привязан к боту. Положительный HTTP-ответ сам по себе не гарантирует доставку сообщения в Telegram.

Проверка выполнения

/update отправляет значение серверу Blynk, но не подтверждает физическое переключение нагрузки. Если прошивка предоставляет пин фактического состояния, запросите его через /get/<PIN_STATE>. Значение отключённого устройства может быть последним сохранённым, поэтому сначала проверяйте /isHardwareConnected.

Auth Token содержится в URL: не передавайте такие ссылки посторонним и не публикуйте их в открытом виде.