FDS2610/monitor
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request 'API.md: Diagnose-Hinweis für last_seen_at auf der Produktionsmaschine' (#21) from fds2610-bot/monitor:main into main

Browse source 
Reviewed-on: https://codeberg.org/fds2610/monitor/pulls/21
This commit is contained in:
fds2610 2026-07-29 17:38:06 +02:00
commit 1879aa7057
1 changed files with 17 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
API.md
View file

@ -88,6 +88,23 @@ Auth: `X-Admin-Key`.
Response: `{ "agents": [ ‹Agent-Objekte wie oben, ohne api_key› ] }` Response: `{ "agents": [ ‹Agent-Objekte wie oben, ohne api_key› ] }`
Oeffentlich, unauthentifiziert (siehe [Grundlagen](#grundlagen)) - damit laesst sich
`last_seen_at` jedes Agenten jederzeit von aussen pruefen, z.B. auf der Produktionsmaschine:
```bash
curl -s "$MONITOR_API_BASE/agents" | jq '.agents[] | {id, display_name, last_seen_at}'
```
Ein Agent gilt im Frontend nur noch als anwesend, solange `last_seen_at` hoechstens zehn
Minuten zurueckliegt (`isAgentPresent`, `html/js/office-scene.js`, Issue #17) - laeuft der
Timeout ab, bleibt sein Schreibtisch leer, obwohl er weiterhin registriert ist. Bei direktem
Zugriff auf die Produktionsmaschine laesst sich derselbe Wert auch direkt aus der
SQLite-Datei lesen (`MONITOR_DB_PATH`, Standard `api/data/monitor.sqlite`):
```bash
sqlite3 "$MONITOR_DB_PATH" "SELECT id, display_name, last_seen_at FROM agents;"
```
### `POST /api/v1/agents/{id}/activity` — Eigenen Zustand melden ### `POST /api/v1/agents/{id}/activity` — Eigenen Zustand melden
Auth: `X-Api-Key` des betroffenen Agenten (ein Agent darf nur seinen eigenen Zustand Auth: `X-Api-Key` des betroffenen Agenten (ein Agent darf nur seinen eigenen Zustand