HTTP-Zeitreihenschnittstelle

Voraussetzung: WiskiPlotMap

Stammdatenschnittstelle

Abfrage der Stations- und Parameterliste.

https://example.com/metadata

Parameter	Beschreibung	mögliche Werte	Standardwert
pgnr	Filter nach Pegel- bzw. Stationsnummer		alle
werte	Filter nach Parameters	W, Q, N, WT, LT, LF	alle
diskr	Filter nach Diskretisierungsintervall in Minuten	10, 15, 60	60
trennz	Spaltentrennzeichen Format	Stringlänge 1 Zeichen	; (Semikolon)

Messdatenschnittstelle

Abfrage der Messdaten.

https://example.com/timeseries?pgnr=203075&werte=W
https://example.com/timeseries?pgnr=203075&werte=W&modus=ZRX&header=true
https://example.com/timeseries?pgnr=203075&werte=W&modus=ZRX&header=true&tage=8
https://example.com/timeseries?pgnr=203075&werte=*&modus=SMET

Parameter	Beschreibung	mögliche Werte	Standardwert
pgnr	Pegel- bzw. Stationsnummer	String	201947
werte	Parameter	String	W
zeitreihe	Zeitreih	Cmd.Ensemble.LARSIM.INCA
beginn	Beginn der Abfrage	Datum im Format JJJJ-MM-TT	gestern
ende	Datum Ende der Zeitreihe	Datum im Format JJJJ-MM-TT	heute
tage	Länge der Zeitreihe ausgehend	1 bis 9 Tage	2 (gestern+heute)
modus	Ausgabeformat, Wenn das Ausgabeformat auf zrxp gesetzt wird, wird der Parameter trennz ignoriert.	ZRX, ZRXP, CSV, LILA, SMET	CSV
header	Ausgabe von ZRXP-Header aktivieren	true, false	false
diskr	Diskretisierungsintervall in Minuten	10, 15, 60	auto
dezipkt	Dezimaltrennzeichen	nummerische Werte Stringlänge 1 Zeichen	. (Punkt)
trennz	Spaltentrennzeichen beim CSV-Format	Stringlänge 1 Zeichen (z.B. %09 für TAB oder %20 für Leerzeichen)	; (Semikolon)
production	Schalter für Original oder Produktionsdaten	P, O	P
t0	Ensemble-Abfrage: t0	last  2022-03-29T00:00:00Z
ensemble	Ensemble-Abfrage: Member-Name	_

Ausgabeformat CSV: Die Antwort besteht aus mehreren Zeilen, jede Zeile besteht aus Zeitpunkt und Wert der Messung, durch das vereinbarte Trennzeichen getrennt. Die Reihung erfolgt chronologisch vom Startzeitpunkt bis zum Endzeitpunkt. Der zeitliche Abstand zwischen zwei Messwerten ist durch die vereinbarte Diskretisierung bestimmt. Bei fehlenden Werten wird nur der Zeitpunkt ohne Wert angegeben (vgl. Beispiel). Das Trennzeichen und das Dezimaltrennzeichen können durch die Request-Parameter geändert werden.

2026-03-15 00:00:00;163.000
2026-03-15 00:15:00;161.000
2026-03-15 00:30:00;161.000
2026-03-15 00:45:00;160.000
...
2026-03-16 02:00:00;153.000
2026-03-16 02:15:00;153.000
2026-03-16 02:30:00;152.000
2026-03-16 02:45:00;152.000

Authentifizierung

Die Authentifizierung erfolgt via HTTP Basic Authentication. Die Kennwörter werden in der Datei datadaemon.properties verwaltet:

datadaemon.credentials = \
	neueruser:$pbkdf2-sha256$600000$0frpE7LQPGPtl1iaxBJOig$XkorIoCxMNwlxI2oAYSnvdd2EGiL71KPopWn/MtfgQ0

Ein neues Kennwort wie folgt erstellt werden:

> D:\TBBM\WiskiPlotMap>d:\TBBM\jdk\bin\java.exe -jar WiskiPlotMap.jar datadaemon --encodePassword=NeuesPasswort
$pbkdf2-sha256$600000$0frpE7LQPGPtl1iaxBJOig$XkorIoCxMNwlxI2oAYSnvdd2EGiL71KPopWn/MtfgQ0

Autorisierung

Die Benutzerrechte werden in WISKI an den Zeitreihengruppen vergeben, die dem Gruppenzweck »Schnittstelle Benutzerrechte« zugeordnet sind.

Für jeden einzelnen Benutzer sind in den Zeitreihengruppen die Zeitreihen zu finden, die der Benutzer abfragen darf.