API-Info für Upload

LineF · September 4, 2024 at 4:38 PM

Hallo,

ich habe jetzt schon etliche Artikel durchsucht - bin aber noch nicht wirklich fündig geworden:

Ich möchte meine Eigenbau-Wetterstation an Awekas ankoppeln und benötige dafür Info, wie ich die Daten hochladen kann.

Am liebsten wäre es mir, wenn ich die Daten direkt per HTTP(S)-Request hochladen kann. Dazu bräuchte ich aber eine API-Beschreibung über Format und Parameter. Für den Download von Daten von Awekas gibts ja ein Dokument (AWEKAS Station API V2-1.pdf). So was ähnliches bräuchte ich für den Upload.

Kann mir jemand weiter helfen?

Martin

HSH-Frosch · September 5, 2024 at 10:07 PM Official Post

LineF Zunächst mal die Antwort auf einen verbreiteten Irrtum: Es gibt keine Möglichkeit eines nachträglichen "Uploads" von historischen Datensätzen mittels HTTP(S). Dafür müsste das Tool AWEKAS-Datenimport genutzt werden, was nur manuell funktioniert (es muss ein bestimmtes Format mit einer bestimmten Spaltenreihenfolge in einem Tabellenkalkulationsprogramm wie Excel erzeugt und im Bereich "Mein AWEKAS" hochgeladen werden).

Wie die Zulieferung von aktuellen Wetterdaten mit einer selbstgebauten Station über http funktioniert, ist ansatzweise hier beschrieben.

Hier mal die Syntax eines Aufruf mit Übergabe der mit einem Semikolon zu trennenden Wetterparameter (Beschreibung und Maßeinheit) in einem durchlaufenden String:

http://data.awekas.at/eingabe_pruefung.php?val=Username;%MD5-Hash(from_Userpassword)%7D;DD.MM.YYYY;hh:mm;temperature_%C2%B0C_outdoors;humidity_%25_outdoors;pressure(QFF)_hPa_sealevel;precipipitation-sum_mm_since_local-midnight;windspeedmean_km/h;winddirection_degrees;currentweathercondition_Code;%7BWarntext%7D;snowdepth_cm;language_flag;pressure-tendency_code;windgust_km/h;solarradiation_W/m%C2%B2;ultraviolet_indexvalue;brightness_lux;sunshineduration_hours_since_local-midnight;soiltemperature_%C2%B0C;rainrate_mm/h;transmissionsoftware_flag_versionnumber

Als Beispiel mal die Meldung der Station Berlin von heute 19:50 Uhr MESZ:

http://data.awekas.at/eingabe_pruefung.php?val=Berliner;XXX;05.09.2024;19:50;27.4;34;1014.9;0.000;11.8;76;2;;0;de;1;32.1;1.4;0.1;3;12.07;28.4;0.00;wswin_2.99.9.1

Nicht vorhandene oder nicht zutreffende Wetterparameter bzw -texte können einfach weggelassen werden, dann folgt im String einfach nur ein weiteres Semikolon (;).

Dahinter können im gleichen String übrigens noch geografische Breite und Länge (bei mobilen Stationen), desweiteren die Höchst- und Tiefstwerte des Tages sowie die in der API-Dokumentation erwähnten Zusatzsensoren für Erdbodentemperaturen, Erdbodenfeuchte, Blattnässe und für Luftqualität als Parameter optional übergeben werden, zum Beispiel:

&indoortemp=25.0
&indoorhumidity=50
&soiltemp1=23.6
&soilmoisture1=15.0
&soiltemp2=22.9
...
&leafwetness1=0.0
&AqPM10=21.2
&AqPM10_avg_24h=26.5
&AqPM2.5=18.4
&AqPM2.5_avg_24h=25.4
&AqPM1=15.6
&AqPM1_avg_24h=18.3

Details zu den bei AWEKAS nutzbaren Wetterzuständen und deren detaillierte Definition findet man hier

Wenn alles an der richtigen Stelle gemeldet wurde, gibt der AWEKAS-Server ein "OK" zurück, ansonsten eine englischsprachige Fehlermeldung.

-> weiterer Link zu einer Forumsdiskussion vom Jahr 2023 zum Thema sendbare Parameter mit einer WeeWX

LineF · September 8, 2024 at 6:36 PM New

Hallo HSH-Frosch,

vielen Dank für die Info! Genau so was habe ich gesucht.
Dann mache ich mich jetzt mal dran, den entsprechenden Request zusammenzubasteln.

Bin gespannt!

Gruss,
Martin

martin9000 · September 10, 2024 at 8:40 AM New

Gibt es auch ein Feld für die Helligkeit in kLux?

Und woher hat "babba" aus dem Symcon-Forum das Format der URL?

LineF · September 10, 2024 at 6:35 PM New

Meine Lux gebe ich im Feld "brightness_lux" mit. Scheint zu funktionieren, denn der Wert taucht dann als kLux auf.

Die Übertragung meiner Wetterdaten funktioniert übrigens mittlerweile aufgrund obiger Beschreibung.
Vielen Dank nochmal an HSH-Frosch!

HSH-Frosch · September 13, 2024 at 10:06 PM New Official Post

Quote from martin9000

Gibt es auch ein Feld für die Helligkeit in kLux?
Und woher hat "babba" aus dem Symcon-Forum das Format der URL?

Ja, gibt es - siehe oben, ist im Wertefeld zwischen UV-Index und aktueller Tagessumme der Sonnenscheindauer (eventuell muss die in Lux gemessene Helligkeit durch 1000 dividiert werden, sollte ja kein Problem sein)

Keine Ahnung, woher dieser Symcon-Forumsuser die Syntax hat..... ein Awekas-Admin ist oder war er jedenfalls nicht, vielleicht hat er auch einfach mal die Meldungen seiner Stationssoftware genauer studiert. Einige Details waren hier im Awekas-Forum aber auch ein häufiges Thema (z.B. ab welchen Grenzwerten in welcher Zeiteinheit gilt ein Luftdruckwert als fallend / steigend bzw stark fallend / stark steigend)

Beste Grüße,

Jörg