Документация API и устройств

Всё, что нужно для подключения вашего устройства: ключи доступа, формат запросов, прошивка и ответы на частые вопросы. Никакой лишней теории — только рабочая информация.

API: HTTPS / JSON Устройства: ESP32 и совместимые Круглосуточный приём данных Последнее обновление: ноябрь 2026
01

Быстрый старт

От регистрации до первой телеметрии на экране — обычно 15–20 минут.

1

Зарегистрируйтесь и войдите в личный кабинет

Создайте аккаунт на портале Adiona. После входа вам будет доступен раздел «Устройства».

2

Добавьте устройство

Нажмите «Добавить устройство», придумайте понятное название (например, «Датчик котельной»). Система сгенерирует два ключа — их вы увидите на карточке устройства.

3

Впишите ключи в прошивку

Скопируйте UID устройства и API-ключ с карточки (кнопка «Копировать») и укажите их в конфигурации прошивки. Готовый пример — в разделе 04.

4

Проверьте на дашборде

Включите устройство. Через несколько секунд карточка на дашборде должна показать статус «онлайн» и первые значения датчиков.

💡Каждое физическое устройство добавляется в личном кабинете отдельно — по одному на плату. Не используйте одни ключи на двух платах: сервер откажет второму в данных.
02

Ключи доступа

У каждого устройства — два идентификатора. Вместе они работают как пара «логин + пароль» для железа.

🆔

UID устройства

dev_a3f81c2e94b7d105

Публичный идентификатор: показывает, какое устройство передаёт данные. Его можно свободно показывать, хранить в документации проекта и вписывать в прошивку.

В личном кабинете отображается серым полем — редактировать его нельзя, он назначается системой автоматически.

🔑

API-ключ

api_xxxxxxxxxxxxxxxxxxxx

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

Храните ключ как пароль: не публикуйте его в открытых репозиториях, не передавайте в чатах и по почте, даже поддержке.

⚠️Если есть подозрение, что API-ключ попал в чужие руки — не ждите инцидента. Обратитесь в поддержку для перевыпуска ключа, после чего впишите новый в прошивку. Старый перестанет работать сразу.
🔁UID устройства тоже можно перевыпустить по запросу в поддержку — например, если вы продали или перепрограммировали плату. Название устройства при этом сохраняется, история данных привязывается к новому UID.
03

Справочник API

Один эндпоинт, один формат запроса. Всё общение устройства с системой — по HTTPS.

📡 Адрес приёма данных

ENDPOINTPOST
https://adionacloud.ru/api.php

Метод — POST, формат тела — JSON, кодировка — UTF-8. Обязательно используйте HTTPS: plain HTTP запросы будут отклонены.

📦 Структура запроса

ПолеТипОбязательноОписание
device_uidstringдаUID устройства из личного кабинета
api_hashstringдаAPI-ключ устройства
batterynumberжелательноЗаряд батареи, % (0–100)
rssinumberжелательноУровень Wi-Fi сигнала, dBm (например, −61)
dataobjectдаПоказания датчиков: пары «название — значение»
ПРИМЕР ЗАПРОСАapplication/json
{
  "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 минут — написать в поддержку
⏱Рекомендуемый интервал отправки телеметрии — от 30 секунд до нескольких минут в зависимости от задачи. Чем реже — тем дольше живёт батарея датчика.
04

Подключение устройства (ESP32)

Готовый фрагмент прошивки: подставьте свои ключи и названия датчиков.

⚡ Минимальный скетч отправки телеметрии

ESP32 / Arduino IDEC++
#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Устройство добавлено в личном кабинете, статус «активно»☐
2device_uid и api_hash скопированы с карточки (не перепечатаны вручную)☐
3В прошивке указан адрес https://adionacloud.ru/api.php — именно HTTPS☐
4Названия датчиков в data — латиницей, без пробелов☐
5Интервал отправки — не чаще одного раза в 30 секунд☐
6Wi-Fi сеть с выходом в интернет, 2.4 ГГц☐
📶ESP32 работает только с диапазоном 2.4 ГГц. Если роутер вещает совмещённую сеть 2.4/5 ГГц под одним именем — на всякий случай создайте отдельную сеть 2.4 ГГц.
05

Устранение неполадок

Найдите свой симптом — под карточкой готовое решение.

Сервер отвечает 401 «не авторизовано»
Причины по частоте: 1) ключи скопированы с ошибкой или с лишними пробелами; 2) ключ был перевыпущен, а в прошивке остался старый; 3) устройство было удалено из кабинета. Откройте карточку устройства, скопируйте оба ключа заново кнопкой «Копировать» и перезалейте прошивку. Если проблема осталась — обратитесь в поддержку.
Сервер отвечает 404 «устройство не найдено»
Проверьте, что device_uid в прошивке совпадает с UID из кабинета символ в символ. Убедитесь, что устройство не удалено и не переведено в статус «архив». Если недавно меняли UID по запросу — старый перестал работать, впишите новый.
Сервер отвечает 400 «неверный формат»
JSON собран с ошибкой: пропущена запятая, кавычка, или тело уходит не как application/json. Сверьте свой пакет с примером из раздела 03 посимвольно. Частая причина — ручная склейка строк без экранирования кавычек.
Устройство «онлайн», но данные не обновляются
Статус меняется, а показания — нет: проверьте, что в поле data действительно передаются значения датчиков, а не пустой объект {}. Также проверьте, не отдаёт ли датчик NaN при ошибке чтения — такие значения сервер отклоняет.
Сервер отвечает 429 «слишком часто»
Интервал отправки короче 60 секунд или прошивка отправляет несколько пакетов за цикл. Установите паузу между отправками минимум 30 секунд — этого достаточно для подавляющего большинства сценариев мониторинга.
Устройство вообще не выходит на связь
Проверьте питание и уровень сигнала (значение rssi хуже −80 dBm означает очень слабый приём — переставьте устройство или добавьте внешний Wi-Fi-модуль). Убедитесь, что сеть открыта, а не за корпоративным порталом, который требует логин в браузере. На плате должен мигать светодиод активности — если нет, перепрошейте плату.
Батарея садится быстрее ожидаемого
Главные «пожиратели»: слишком частая отправка, активный Wi-Fi без режимов сна, лишние подключения к сети. Увеличьте интервал телеметрии, используйте WiFi.setSleep(true) и глубокий сон (esp_deep_sleep) между отправками. Для батарейных датчиков нормальный интервал — 5–15 минут.
06

Частые вопросы

Можно ли переименовать устройство?
Да, в любой момент — название ни на что не влияет технически. А вот UID менять не нужно: прошивка привязана именно к нему.
Что делать, если продал устройство или оно сломалось?
Не оставляйте ключи «висеть»: обратитесь в поддержку для перевыпуска или отключения устройства. Новый владелец должен получить свои собственные ключи через свой аккаунт.
Можно ли добавить одно устройство на два аккаунта?
Нет. Каждому физическому устройству — одна пара ключей и один владелец. Совместный доступ настраивается на уровне приглашения к вашему аккаунту.
С какими платами это работает?
Любая плата с Wi-Fi и HTTP(S)-клиентом: ESP32, ESP8266 (с поддержкой TLS), Raspberry Pi и другие. Пример выше — для ESP32.
Как часто можно отправлять данные?
Минимум раз в 60 секунд на устройство. Для батарейных датчиков рекомендуемый интервал — 1–15 минут.

🛟 Не нашли ответ? Напишите в поддержку

Чтобы мы помогли с первого письма, приложите к обращению:

  • UID устройства (его можно показывать — это не секрет);
  • точный ответ сервера — код и текст;
  • что прошивка выводит в Serial-монитор;
  • когда проблема началась и что меняли до этого.
🔒API-ключ даже поддержке сообщать не нужно и нельзя. Никакой сотрудник запросит его — при любом таком запросе это мошенник.