History

Christian Johannesen bbceaeb58a Improve payload request dashboard		2026-10-24 22:21:34 +02:00
..
public	Improve payload request dashboard	2026-10-24 22:21:34 +02:00
scripts	Add DS18B20 payload sketch	2026-10-24 21:44:02 +02:00
src	Improve payload request dashboard	2026-10-24 22:21:34 +02:00
.dockerignore
Dockerfile
nginx.conf
package-lock.json
package.json
README.md	Identify API callers and filter dashboard traffic	2026-10-24 20:13:31 +02:00

README.md

Arduino Playground-server

Compose-stacken leverer:

webdashboard på /;
REST API på /api.

Start

Opret den lokale .env fra WiFi-status-sketchens secrets og start stacken:

npm --prefix server run configure
docker compose up -d --build

Med standardopsætningen åbnes dashboardet på http://localhost:8152.

API

Læsning er offentlig:

GET /api/health
GET /api/activity
GET /api/payloads
GET /api/payloads/:id

Skrivning kræver Authorization: Bearer <API_BEARER_TOKEN>:

POST   /api/payloads
PATCH  /api/payloads/:id
DELETE /api/payloads/:id

Eksempel på body til POST:

{
  "topic": "r4/status",
  "payload": {
    "temperature": 22.4,
    "online": true
  }
}

Boardet bør identificere sig på alle kald. Aktivitetsdashboardet prioriterer X-Device-ID, derefter X-Client-Name og til sidst klientens IP-adresse:

X-Device-ID: uno-r4-wifi-01
X-Client-Name: wifi-status-sketch

Dashboardets egne forespørgsler markeres internt og gemmes ikke i aktivitetsloggen. GET-kald uden X-Device-ID eller X-Client-Name udelades også, så anonyme dashboard- og overvågningskald ikke overdøver boardtrafikken.

WiFi-oplysningerne ligger kun i den lokale .env til brug for den kommende board-sketch. De sendes ikke til browseren eller API-klienter.