Sensor API

Эндпоинты, предназначенные для взаимодействия с аппаратными датчиками.

---

Получить конфигурацию

Предоставляет данные конфигурации для датчика, такие как требуемая частота отправки данных.

• Метод: GET

• Путь: /api/sensor/config/

Успешный ответ (200 OK):

{
  "period": 30
}

• period (integer): Период в секундах, с которым датчик должен отправлять данные.

---

Отправить данные температуры

Принимает и сохраняет данные о температуре от датчика. Сервер автоматически идентифицирует датчик по его IP-адресу.

• Метод: POST

• Путь: /api/sensor/data/

Тело запроса (JSON):

Необходимо предоставить хотя бы одно из полей.

{
  "contact_temp": 36.7,
  "non_contact_temp": 36.1
}

• contact_temp (float, опционально): Температура, измеренная контактным способом.

• non_contact_temp (float, опционально): Температура, измеренная бесконтактным способом.

Ответы:

• 201 Created: Данные успешно приняты и сохранены.

• 400 Bad Request: Тело запроса невалидно (например, не предоставлено ни одного поля с температурой).

• 429 Too Many Requests: Превышен лимит на частоту отправки данных.

---

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

Возвращает список последних 50 показаний температуры для устройства с указанным IP-адресом.

• Метод: GET

• Путь: /api/sensor/device/{ip_address}/readings/

Параметры пути:

• ip_address (string): IP-адрес устройства, для которого запрашиваются данные.

Успешный ответ (200 OK):

[
  {
    "timestamp": "2023-10-27T10:05:00Z",
    "contact_temp": 36.5,
    "non_contact_temp": 35.8
  },
  {
    "timestamp": "2023-10-27T10:04:30Z",
    "contact_temp": 36.6,
    "non_contact_temp": null
  }
]

Ответы:

• 404 Not Found: Устройство с указанным IP-адресом не найдено в системе.