Всё, что нужно для подключения вашего устройства: ключи доступа, формат запросов, прошивка и ответы на частые вопросы. Никакой лишней теории — только рабочая информация.
От регистрации до первой телеметрии на экране — обычно 15–20 минут.
Создайте аккаунт на портале Adiona. После входа вам будет доступен раздел «Устройства».
Нажмите «Добавить устройство», придумайте понятное название (например, «Датчик котельной»). Система сгенерирует два ключа — их вы увидите на карточке устройства.
Скопируйте UID устройства и API-ключ с карточки (кнопка «Копировать») и укажите их в конфигурации прошивки. Готовый пример — в разделе 04.
Включите устройство. Через несколько секунд карточка на дашборде должна показать статус «онлайн» и первые значения датчиков.
У каждого устройства — два идентификатора. Вместе они работают как пара «логин + пароль» для железа.
dev_a3f81c2e94b7d105
Публичный идентификатор: показывает, какое устройство передаёт данные. Его можно свободно показывать, хранить в документации проекта и вписывать в прошивку.
В личном кабинете отображается серым полем — редактировать его нельзя, он назначается системой автоматически.
api_xxxxxxxxxxxxxxxxxxxx
Секретный ключ: подтверждает, что данные отправляет владелец устройства. Знание одного UID без ключа бесполезно для злоумышленника.
Храните ключ как пароль: не публикуйте его в открытых репозиториях, не передавайте в чатах и по почте, даже поддержке.
Один эндпоинт, один формат запроса. Всё общение устройства с системой — по HTTPS.
https://adionacloud.ru/api.php
Метод — POST, формат тела — JSON, кодировка — UTF-8. Обязательно используйте HTTPS: plain HTTP запросы будут отклонены.
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
device_uid | string | да | UID устройства из личного кабинета |
api_hash | string | да | API-ключ устройства |
battery | number | желательно | Заряд батареи, % (0–100) |
rssi | number | желательно | Уровень Wi-Fi сигнала, dBm (например, −61) |
data | object | да | Показания датчиков: пары «название — значение» |
{
"device_uid": "dev_a3f81c2e94b7d105",
"api_hash": "api_xxxxxxxxxxxxxxxxxxxx",
"battery": 87,
"rssi": -61,
"data": {
"temperature": 23.4,
"humidity": 48
}
}data — на английском, латиницей, без пробелов (temperature, pressure_hpa). На дашборде можно присвоить им понятные русские подписи при настройке карточки.| Код | Значение | Что делать устройству | Что делать вам |
|---|---|---|---|
| 200 | Данные приняты | Продолжать работу | — |
| 401 | Ключ не принят | Не повторять запрос | Проверить device_uid и api_hash в прошивке; сверить с личным кабинетом |
| 404 | Устройство не найдено или удалено | Не повторять запрос | Проверить UID и статус устройства в кабинете |
| 400 | Неверный формат JSON | Проверить сборку пакета | Сверить пример из этой документации |
| 429 | Слишком частые запросы | Увеличить интервал отправки | Настроить период не чаще 1 раза в 30 секунд |
| 500 | Временная ошибка сервера | Повторить через 60 с | Если повторяется дольше 15 минут — написать в поддержку |
Готовый фрагмент прошивки: подставьте свои ключи и названия датчиков.
#include <WiFi.h> #include <HTTPClient.h> // ---------- Настройки из личного кабинета ---------- const char* WIFI_SSID = "ВАШ_WIFI"; const char* WIFI_PASS = "ПАРОЛЬ_WIFI"; const char* DEVICE_UID = "dev_a3f81c2e94b7d105"; // с карточки устройства const char* API_HASH = "api_xxxxxxxxxxxxxxxxxxxx"; // секретный ключ const char* API_URL = "https://adionacloud.ru/api.php"; void sendTelemetry(float temp, float hum) { if (WiFi.status() != WL_CONNECTED) return; HTTPClient http; http.begin(API_URL); http.addHeader("Content-Type", "application/json"); // Собираем JSON-пакет String payload = "{"; payload += "\"device_uid\":\"" + String(DEVICE_UID) + "\","; payload += "\"api_hash\":\"" + String(API_HASH) + "\","; payload += "\"battery\":" + String(87) + ","; payload += "\"rssi\":" + String(WiFi.RSSI()) + ","; payload += "\"data\":{\"temperature\":" + String(temp) + ",\"humidity\":" + String(hum) + "}"; payload += "}"; int code = http.POST(payload); http.end(); // code == 200 — данные приняты } void setup() { Serial.begin(115200); WiFi.begin(WIFI_SSID, WIFI_PASS); while (WiFi.status() != WL_CONNECTED) delay(500); } void loop() { // TODO: здесь ваши датчики, например DHT22 sendTelemetry(23.4, 48); delay(60000); // отправка раз в минуту }
| # | Пункт | Готово? |
|---|---|---|
| 1 | Устройство добавлено в личном кабинете, статус «активно» | ☐ |
| 2 | device_uid и api_hash скопированы с карточки (не перепечатаны вручную) | ☐ |
| 3 | В прошивке указан адрес https://adionacloud.ru/api.php — именно HTTPS | ☐ |
| 4 | Названия датчиков в data — латиницей, без пробелов | ☐ |
| 5 | Интервал отправки — не чаще одного раза в 30 секунд | ☐ |
| 6 | Wi-Fi сеть с выходом в интернет, 2.4 ГГц | ☐ |
Найдите свой симптом — под карточкой готовое решение.
device_uid в прошивке совпадает с UID из кабинета символ в символ. Убедитесь, что устройство не удалено и не переведено в статус «архив». Если недавно меняли UID по запросу — старый перестал работать, впишите новый.
application/json. Сверьте свой пакет с примером из раздела 03 посимвольно. Частая причина — ручная склейка строк без экранирования кавычек.
data действительно передаются значения датчиков, а не пустой объект {}. Также проверьте, не отдаёт ли датчик NaN при ошибке чтения — такие значения сервер отклоняет.
rssi хуже −80 dBm означает очень слабый приём — переставьте устройство или добавьте внешний Wi-Fi-модуль). Убедитесь, что сеть открыта, а не за корпоративным порталом, который требует логин в браузере. На плате должен мигать светодиод активности — если нет, перепрошейте плату.
WiFi.setSleep(true) и глубокий сон (esp_deep_sleep) между отправками. Для батарейных датчиков нормальный интервал — 5–15 минут.
Чтобы мы помогли с первого письма, приложите к обращению: