API für Geo Positions Update mit Testscript

This commit is contained in:
concierge committed 2026-11-04 14:42:45 +01:00
1 parent 23a9df66f4
commit d54a986c14
16 files changed
+1027 -6

No files matched your search

+47
View File
@@ -101,6 +101,53 @@ Eine ausführliche Beschreibung des Protokolls, der Brokerlogik, der
Nebenläufigkeit und der aktuellen Abweichungen steht in
[`../doc/broker.md`](../doc/broker.md).
## Externe Gruppenpositions-API
Externe Systeme können die Position einer Gruppe per HTTP-POST melden:
```http
POST /<tenant>/api/groups/position
Content-Type: application/json
{
"lat": 50.701243,
"lon": 7.153290,
"timestamp": "2026-11-04T12:00:00Z",
"token": "<API-Zugriffstoken>",
"aliasname": "Gruppe 1"
}
```
Der Zeitstempel kann als ISO-8601-String oder als Unix-Zeit in Sekunden bzw.
Millisekunden angegeben werden; Zeitangaben ohne Zeitzone werden als UTC
interpretiert. Ist er älter als der in der Datenbank gespeicherte
`last_pos_at`, wird weder die Datenbank noch der Broker aktualisiert. Eine erfolgreiche Aktualisierung wird als Code-300-Nachricht an
Dispatcher, Beobachter und die betroffene Gruppe verteilt.
Die Zugriffstoken sind mandantenweit gültig und werden im Admin-Dashboard
unter **API-Zugriffstoken** angezeigt. Dort kann jeder Token einzeln gelöscht
und ein neuer zufälliger Token erzeugt werden. Ohne einen gültigen Token wird
der Request mit HTTP 401 abgewiesen.
Zum Testen des Endpunkts dient `scripts/test_group_position_api.py`. Es liest
Koordinaten aus `../data/rv-hnr.csv`, verwendet standardmäßig den ersten Token
und die erste Gruppe des Mandanten `RV` und prüft Aktualisierung, ältere
Zeitstempel und ungültige Tokens:
```bash
python scripts/test_group_position_api.py
```
Alternativ lassen sich Token und Gruppe explizit angeben:
```bash
python scripts/test_group_position_api.py \
--base-url http://127.0.0.1:5000 \
--tenant RV \
--alias "Gruppe 1" \
--token "<API-Zugriffstoken>"
```
## Erste Einrichtung
Nach der Initialisierung der Datenbank müssen noch Mandanten und ein Admin-Account angelegt werden.