Devices API

E-Paper Display Management.

List Devices

GET /api/v1/devices

Response

{
  "success": true,
  "data": [
    {
      "id": "dev_001",
      "name": "Showroom Display 1",
      "location": "Eingang links",
      "assignedProduct": "prod_palace90lmf",
      "status": "online",
      "lastSeen": "2026-01-15T10:30:00Z",
      "batteryLevel": 85,
      "firmwareVersion": "1.2.0"
    }
  ]
}

Register Device

POST /api/v1/devices

Request Body

{
  "macAddress": "AA:BB:CC:DD:EE:FF",
  "name": "Showroom Display 2",
  "location": "Mitte"
}

Get Display Content

GET /api/v1/devices/:id/display

Gibt den aktuellen Displayinhalt als Bitmap zurück.

Response

{
  "success": true,
  "data": {
    "modelLine": "PALACE",
    "model": "90 LMF",
    "price": "€279.900",
    "availability": "Sofort verfügbar",
    "qrCode": "https://konfigurator.morelo.de/palace-90-lmf",
    "lastUpdated": "2026-01-15T02:00:00Z"
  }
}

Device Heartbeat

POST /api/v1/devices/:id/heartbeat

Vom ESP32 alle 15 Minuten gesendet.

Request Body

{
  "batteryLevel": 85,
  "wifiRssi": -65,
  "firmwareVersion": "1.2.0"
}