API für Geo Positions Update mit Testscript
This commit is contained in:
1 parent
23a9df66f4
commit
d54a986c14
16 files changed
+1027
-6
No files matched your search
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user