AQUA SMART

API Справка

REST API документация за AQUA SMART

Базов URL

https://aquasmart.balkanhost.bg/api

Аутентификация

AQUA SMART API използва Bearer tokens за аутентификация:

Authorization: Bearer YOUR_ACCESS_TOKEN

Токенът се получава при вход и важи 24 часа.

Endpoints

GET /sensors

Получаване на списък със всички сензори

Response: Array of sensors with current readings

GET /sensors/:id

Получаване на конкретен сензор с детайлите

Response: Sensor object with full details

GET /sensors/:id/readings

Получаване на исторически данни за сензор

Query params: from, to, limit (default: 100)

GET /reservoirs

Получаване на списък със всички язовири

Response: Array of reservoirs with current status

GET /alerts

Получаване на активни алерти

Response: Array of alerts grouped by severity

POST /alerts

Създаване на нов алерт за сензор

Body: { sensorId, threshold, type }

Примери на отговори

Sensor Response

{
  "id": "dam_ogosta",
  "name": "Язовир Огоста",
  "type": "water_level",
  "status": "active",
  "currentValue": 82.5,
  "unit": "%",
  "capacity": 303.8,
  "capacityUnit": "млн м³",
  "lastReading": "2026-03-05T14:30:00Z",
  "latitude": 43.7845,
  "longitude": 24.1234
}

Alert Response

{
  "id": "alert_001",
  "sensorId": "dam_erma",
  "type": "critical",
  "threshold": 50,
  "currentValue": 41.3,
  "message": "Критично ниско ниво на вода",
  "createdAt": "2026-03-05T14:25:00Z",
  "status": "active"
}

HTTP Статус кодове

200 OKУспешен заявка

400 Bad RequestНевалидни параметри

401 UnauthorizedЛипсва или невалиден токен

404 Not FoundРесурсът не е намерен

500 Internal Server ErrorГрешка на сървъра

Rate Limiting

API има ограничение от 1000 заявки на час на IP адрес. Превишаването ще резултира в 429 Too Many Requests статус.

Поддържа

За помощ с API интеграция, свържете се на: radostinhristov36@gmail.com