API v1

API документация

Daemon API принимает измерения, Mobile API обслуживает Android-клиент. Токены разделены по типу и правам.

Авторизация

Authorization: Bearer <token>

Daemon-токены имеют префикс thd_live_. Мобильные токены имеют префикс thm_live_ и не могут отправлять измерения.

Daemon API

GET /api/v1/meПроверить токен
GET /api/v1/sensorsПолучить датчики
POST /api/v1/measurementsЗаписать измерение
POST /api/v1/measurements/batchЗаписать пачку атомарно
GET /api/v1/sensors/{id}/measurementsПолучить историю

Mobile API

GET /api/mobile/v1/bootstrapПубличная конфигурация
POST /api/mobile/v1/auth/yandexОбменять OAuth code на mobile token
GET /api/mobile/v1/meПрофиль пользователя
POST /api/mobile/v1/logoutОтозвать текущий mobile token
GET /api/mobile/v1/dashboardСводка главного экрана
GET /api/mobile/v1/sensorsСписок датчиков

Одно измерение

POST /api/v1/measurements
Content-Type: application/json
Authorization: Bearer thd_live_...

{
  "event_id": "device-01-20260710-000001",
  "sn": "28FF641D931603A1",
  "temp": 23.45,
  "timestamp": "2026-07-10T12:30:00Z"
}

event_id рекомендуется передавать всегда. Повторный запрос с тем же идентификатором не создаст дубль.

Пачка измерений

POST /api/v1/measurements/batch
Content-Type: application/json
Authorization: Bearer thd_live_...

{
  "measurements": [
    {"event_id": "dev-1", "sn": "28FF01", "temp": 23.4},
    {"event_id": "dev-2", "sn": "28FF02", "temp": 21.1}
  ]
}

Вся пачка валидируется заранее и сохраняется одной транзакцией. Максимум 500 элементов.

История

GET /api/v1/sensors/1/measurements?from=2026-07-01T00:00:00Z&to=2026-07-07T00:00:00Z&bucket=hour

Допустимые bucket: raw, minute, 5min, 15min, hour, day. Для raw максимальный период — 7 дней.