Table of Contents
Adjust forecast
(Personal account upwards)
The POST
method will be removed until end of 2023!
You can send actual production data to adjust the forecast matching your actual real production, it will affect only the actual day, not the next days.
The internal correction observes all planes and corrects the forecast as a whole.
Please note that if you send correction data very early in the day, this can have a massive effect on the daily forecast!
Submit the actual absolute plant production direct during a forecast request.
With any call for a forecast
https://api.forecast.solar/:apikey/estimate/...
you can direct add a query parameter (always in absolute kWh)
?actual=<float kWh>
In the message
> info
section of the response the used corrections will be included.
Reset
Just in case, to reset the correction factors and delete the actual value just send 0
.
?actual=0
POST
Deprecated from 2024
You can submit the actual relative plant production for your location.
Production value here must given always in kWh/kWp (relative)
Send a POST request to this URL:
https://api.forecast.solar/:apikey/actual/:lat/:lon
URI parameters:
:apikey
- personal API key; string:lat
- latitude of location,-90
(south) …90
(north); float:lon
- longitude of location,-180
(west) …180
(east); float
POST data:
value
- required; actual relative plant production in kWh/kWp; floattimestamp
- optional; a unix timestamp or any datetime string parsable by PHPstrtotime()
; int or string, defaultnow
cUrl example
curl --request POST 'https://api.forecast.solar/<your API key>/actual/<latitude>/<longitude>' \ --form 'value="<float kWh/kWp>"' --form 'timestamp="<int or string>"'
This will respond HTTP code 201
on success, 400
on error.
This will affect your location and locations in a radius nearby.
Reset
Just in case, to delete the actual value just send an empty POST without data
curl --request POST 'https://api.forecast.solar/<your API key>/actual/<latitude>/<longitude>'
This will respond HTTP code 204
on success, 400
on error.
This will affect your location and locations in a radius nearby.