Note: Anyone who would like to support me is welcome to make a small donation: Donate. Thank you very much.
https://www.solarprognose.de/web/solarprediction/api/v1
?access-token=ACCESS-TOKEN (Enter here your API Key, click here to find it.)
&project=Please add here your projects website or your contact email so that I can get in contact with you if necessary.
&item=ITEM&id=ID
Alternative: &item=ITEM&token=TOKEN
Alternative: If you have only one location you do not need to send item/id/token, the API will return data for first location
&type=hourly|daily &_format=json|xml &algorithm=mosmix|own-v1|clearsky
Optional parameter:
&day=DAY
&start_epoch_time=START_EPOCH_TIME&end_epoch_time=END_EPOCH_TIME
&start_day=START_DAY&end_day=END_DAY
&snomminixml=true # for snom VoIP telephones
STATUS_OK = 0; STATUS_ERROR_INVALID_ACCESS_TOKEN = -2; STATUS_ERROR_MISSING_PARAMETER_ACCESS_TOKEN = -3; STATUS_ERROR_EMPTY_PARAMETER_ACCESS_TOKEN = -4; STATUS_ERROR_INVALID_TYPE = -5; STATUS_ERROR_MISSING_TYPE = -6; STATUS_ERROR_INVALID_ID = -7; STATUS_ERROR_ACCESS_DENIED = -8; STATUS_ERROR_INVALID_ITEM = -9; STATUS_ERROR_INVALID_TOKEN = -10; STATUS_ERROR_NO_SOLAR_DATA_AVAILABLE = -11; STATUS_ERROR_NO_DATA = -12; STATUS_ERROR_INTERNAL_ERROR = -13; STATUS_ERROR_UNKNOWN_ERROR = -14; STATUS_ERROR_INVALID_START_DAY = -15; STATUS_ERROR_INVALID_END_DAY = -16; STATUS_ERROR_INVALID_DAY = -17; STATUS_ERROR_INVALID_WEATHER_SERVICE_ID = -18; STATUS_ERROR_DAILY_QUOTA_EXCEEDED = -19; STATUS_ERROR_INVALID_OR_MISSING_ELEMENT_ITEM = -20; STATUS_ERROR_NO_PARAMETER = -21; STATUS_ERROR_INVALID_PERIOD = -22; STATUS_ERROR_INVALID_START_EPOCH_TIME = -23; STATUS_ERROR_INVALID_END_EPOCH_TIME = -24; STATUS_ERROR_ACCESS_DENIED_TO_ITEM_DUE_TO_LIMIT = -25; STATUS_ERROR_NO_CLEARSKY_VALUES = -26; STATUS_ERROR_MISSING_INPUT_ID_AND_TOKEN = -27; STATUS_ERROR_INVALID_ALGORITHM = -28; STATUS_ERROR_FAILED_TO_LOAD_WEATHER_LOCATION_ITEM = -29;
... "preferredNextApiRequestAt":{ "secondOfHour":120, # (Execute the api request in the 120. second of the hour.) "epochTimeUtc":1626796920 # (Execute the next api request at this epoch time.) }
https://www.solarprognose.de/web/solarprediction/api/v1?access-token=454jelfd&item=inverter&id=2&type=hourly
{ "status":0, "iLastPredictionGenerationEpochTime":1576681137, "datalinename":"Süd", "data":{ "1576735200":[0,0], // timestamp: kilowatt/kw, accumulated kwh "1576738800":[0.064,0.064], "1576742400":[0.606,0.67], "1576746000":[1.148,1.818], "1576749600":[1.647,3.465], "1576753200":[0.295,3.76], "1576756800":[0.273,4.033], "1576760400":[1.3,5.333], "1576764000":[0.305,5.638], "1576767600":[0.014,5.652], "1576771200":[0,5.652], ... the other days follow } }
https://www.solarprognose.de/web/solarprediction/api/v1?access-token=454jelfd&item=inverter&id=2&type=daily
{ "iLastPredictionGenerationEpochTime":1576686390, "status": 0, "datalinename": "SMASB2000TL" "data": { "20151212": 1.978, // yyymmdd: kwh per day "20151213": 1.999, "20151214": 4.049, "20151215": 5.567, "20151216": 1.948, "20151217": 1.925 }, }
https://www.solarprognose.de/web/solarprediction/api/v1?_format=json&access-token=454jelfd&item=inverter&id=2&type=hourly&day=1
{ "status":0, "iLastPredictionGenerationEpochTime":1576681137, "datalinename":"Süd", "data":{ "1576735200":[0,0], "1576738800":[0.064,0.064], "1576742400":[0.606,0.67], "1576746000":[1.148,1.818], "1576749600":[1.647,3.465], "1576753200":[0.295,3.76], "1576756800":[0.273,4.033], "1576760400":[1.3,5.333], "1576764000":[0.305,5.638], "1576767600":[0.014,5.652], "1576771200":[0,5.652] } }
https://www.solarprognose.de/web/solarprediction/api/v1?access-token=454jelfd&item=inverter&token=DEF&type=hourly https://www.solarprognose.de/web/solarprediction/api/v1?access-token=454jelfd&item=inverter&token=DEF&type=daily https://www.solarprognose.de/web/solarprediction/api/v1?access-token=454jelfd&item=inverter&token=DEF&type=hourly&day=-1