APILeifaden

Hier erfährst du Schritt für Schritt, wie du unsere API nutzen kannst.

Hinweis: Für Entwicklung und Dokumentation der StromGedacht-API haben wir das Open-Source-Tool Swagger genutzt.

Die StromGedacht-API bietet vier Abruffunktionen für Netzdaten:

/v1/now: Abruf des StromGedacht-Zustands für den gegenwärtigen Zeitpunkt zu einer gegebenen Postleitzahl

/v1/states: Abruf der StromGedacht-Zustände für einem spezifizierten Zeitraum zu einer gegebenen Postleitzahl, wobei der Status maximal 4 Tage in die Vergangenheit und maximal 2 Tage in die Zukunft abgefragt werden kann.

/v1/statesRelative: Abruf der StromGedacht-Zustände für eine spezifizierte Anzahl von Stunden in der Zukunft sowie in der Vergangenheit (optional) relativ zum Abfragezeitpunkt. Es kann maximal 4 Tage in die Vergangenheit und maximal 2 Tage in die Zukunft abgefragt werden.

/v1/forecast: Abruf verschiedener Metriken wie der Last im Netz, der vorhandenen Leistung aus erneuerbaren Energien, der Residuallast sowie der Supergrün-Schwelle zu einer gegebenen Postleitzahl. Es können historische Daten abgefragt werden. Es kann maximal 1 Tag in die Zukunft abgefragt werden.

Die StromGedacht-API ist unter https://api.stromgedacht.de aufrufbar.

Dies kann beispielsweise mittels cURL geschehen.

Hier haben wir einige Code-Beispiele für Python und R für dich bereitgestellt: