Holfuy Weather Report API V4.1
Parameters:
s: station(s) ID e.g. s=101 or you can get the data from more stations by one query as well (coma separated list) e.g. s=101,102,103 . If you would get all stations' data (to which you have access) by one single API call please use the "all" string -> s=all .
pw: password for the API access (it could be sent by a POST "pw" parameter also)
m:mode XML or CSV or JSON default: CSV
avg:averaging "0": newest data from the station, "1" newest quarter hourly average, "2" newest hourly average (default = 0)
su: wind speed unit: knots, km/h, m/s, mph, default: m/s
tu: temperature unit C:Celsius , F: Fahrenheit default: Celsius
batt: add this parameter to get the station's battery voltage (JSON only).
cam: add this parameter to the URL for timestamp of the last picture from the camera. (JSON only, only for stations with a camera)
daily: add this parameter to get daily Max-Min temperatures and precipitation since last midnight CE(S)T (JSON only, max 5 stations)
loc: add this parameter to the URL to get the station's location in reply too (JSON only)
utc: add this parameter to the URL for timestamps in UTC, otherwise times will be in CE(S)T
Data:
DateTime: time of the last data / average in ".date('T')." (Central European Time) or in UTC if utc param is set.
Examples:
JSON: http://api.holfuy.com/live/?s=101&pw=pass&m=JSON&tu=C&su=m/s (Check the source file at your browser for this output)
CSV: http://api.holfuy.com/live/?s=101&pw=pass&m=CSV&tu=C&su=km/h
Output: ID,name,date,time,speed,gust,speed unit, direction, temp, temp unit[, humidity (%)][,pressure (hPa, standard)][,light (0-1000 custom scale)][,rain (mm)][,2nd Temperature sensor][,solar radiation W/m^2][,soil moisture %]
XML: http://api.holfuy.com/live/?s=101&pw=pass&m=XML&tu=C&su=m/s (Check the source file at your browser for this output)
By using Holfuy's API services you confirm that you have read and agree to Holfuy's Terms and Conditions.
Revision history:
- V4.2 | 2022.02.02.: soil moisture values are reported from now
- V4.1 | 2021.02.15.: dir_letter option is available for XML outout (89°-> E), German only
- V4.0 | 2020.10.12.: clarify JSON output format
- V3.3 | 2020.09.01.: daily rain and max-min temperatures are calculated from midnight at the station's local timezone. Daily rain values are fixed
- V3.2 | 2020.05.25.: too many API calls in a short period limited
- V3.1 | 2020.02.17.: minimum wind speed supported by the API in JSON mode
- V3.0 | 2019.10.11.: 'loc' optional parameter for station's location info is available
- V2.9 | 2019.01.14.: Daily max & min temperatures and daily precipitation values are available by the 'daily' parameter
- V2.8 | 2018.07.27.: solar radiation value added to the output for stations which has a solar radiation sensor
- V2.7 | 2018.07.19.: 'batt' parameter is available for battery voltage
- V2.6 | 2018.04.25.: in CSV mode if more stations' data requested by one call: API will leave fields empty for the not available sensors' data to keep the field order
- V2.5 | 2018.04.04.: 'lws' and 'lws_cnt' values in JSON mode for stations with METER leaf wetness sensor
- V2.4 | 2018.03.14.: 'cam' optional parameter added for last image timestamp