Using the enercast SEF API

enercast SEF API uses HTTP POST requests. All relevant parameters are passed as a JSON Object in the request body.

POST https://portal.enercast.de/api/siteforecast/v1/current/pv

Request

  • Authentication: HTTP Basic Auth according to RFC 2617
  • Content-Type: application/json

Example Request Body

{
"latitude": 41.2,
"longitude": 11.7,
"installedCapacity": 1000,
"tilt": 20,
"azimuth":-20
}

Parameter Type Description
latitude Number Latitude (WGS84)
longitude Number Longitude (WGS84)
installedCapacity Number Installed Capacity (W)
tilt Number Tilt (º; 0 = horizontal, 90 = vertical)
azimuth Number Orientation (º; 0 = South, -90 = East, 90 = West, 180 = North)

Response

  • Content-Type: application/json

Example Response Body

{
"2019-09-03T01:00Z": 0.0,
"2019-09-03T02:00Z": 0.0,
"2019-09-03T03:00Z": 0.0,
"2019-09-03T04:00Z": 0.0,
"2019-09-03T05:00Z": 991.6641238862992,
"2019-09-03T06:00Z": 7077.562694426738,
"2019-09-03T07:00Z": 10716.250452362232,
[...],
"2019-09-06T05:00Z": 1352.0472043846005
}

The response body is a JSON object consisting of key-value pairs of timestamp and power.

  • Key: Timestamp of interval end according to ISO 8601, format “yyyy-MM-dd’T’HH:mmZ”
  • Value: Mean power in the interval (W)