Verwendung der enercast SEF API

Die Anfrage an die enercast SEF API wird als HTTP-POST-Request gestellt. Alle relevanten Parameter werden als JSON-Objekt im Request Body übergeben.

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

Request

  • Authentifizierung: HTTP Basic Auth nach RFC 2617
  • Content-Type: application/json

Beispiel Request-Body

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

Parameter Typ Beschreibung
latitude Zahl Breitengrad (WGS84)
longitude Zahl Längengrad (WGS84)
installedCapacity Zahl Installierte Leistung (W)
tilt Zahl Neigung (º; 0 = horizontal, 90 = vertikal)
azimuth Zahl Ausrichtung (º; 0 = Süden, -90 = Osten, 90 = Westen, 180 = Norden)

Response

  • Content-Type: application/json

Beispiel 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
}

Der Response-Body ist ein JSON-Object, das aus Key-Value-Paaren aus Zeitstempel und Leistung aufgebaut ist.

  • Key: Zeitstempel des Interval-Endes nach ISO 8601 im Format „yyyy-MM-dd’T’HH:mmZ“
  • Value: Mittlere Leistung im Intervall (W)