Die StromGedacht
API
Mit unserer Programmierschnittstelle (API) ermöglichen wir dir Zugriff auf die Statusanzeige des Stromnetzes, wie sie auch in der StromGedacht-App angezeigt wird. Mithilfe der StromGedacht-API kannst du zum Beispiel Haushaltsgeräte deines Smart Homes intelligent zu den Zeiten laufen lassen, in denen sich das Stromnetz im Normalbetrieb befindet, oder in denen der Verbrauch in Vorbereitung auf eine angespannte Netzsituation vorverlegt werden soll. Während einer angespannten Netzsituation kannst du automatisiert den Verbrauch von Haushaltsgeräten reduzieren oder nicht notwendige Geräte abschalten lassen.
Dokumentation
So kannst du die API nutzen
Für Entwicklung und Dokumentation der StromGedacht-API haben wir das Open-Source-Tool Swagger genutzt.
Nutzungsbedinungen API
Datenschutzerklärung API
Leitfaden zur Nutzung der API
Hier erfährst du Schritt für Schritt, wie du unsere API nutzen kannst.
Zum Leitfaden
So erreichst du die API
Die StromGedacht-API sowie deren Dokumentation stehen hier für dich zur Verfügung:
api.stromgedacht.de
Updates
Erhalte Infos bei Updates der API
FAQ
Fragen und Antworten zur API
Welchen Bedingungen unterliegt die Nutzung der API?
Die Nutzung der API und mittels der API bereitgestellten Daten ist kostenfrei und nur zu privaten Zwecken ohne Gewinnerzielungsabsicht gestattet. Eine Weitergabe der Daten an Dritte darf nur unter Angabe der Quelle StromGedacht, TransnetBW GmbH
erfolgen. Bei Weitergabe und/oder Nutzung der Daten würden wir uns über einen Link auf unsere Homepage (https://www.stromgedacht.de/) freuen. Bitte wende dich an [email protected], wenn du die API oder darüber bereitgestellte Daten zu geschäftlichen Zwecken nutzen willst. Die vollständigen Nutzungsbedingungen der API findest du hier.
Welche Daten kann ich über die API wie oft abrufen?
Mittels der API kannst du automatisiert und zwar maximal sechs Mal pro Minute den StromGedacht-Status (Grün, Gelb, Orange, Rot) für einen definierten Zeitraum und Standort abfragen. Bitte beachte, dass die StromGedacht-Prognosen immer nur maximal zwei Tage in die Zukunft abfragbar sind. Ferner können die StromGedacht-Daten bis maximal vier Tage in die Vergangenheit abgefragt werden. Es werden nur Daten für angegebene Standorte in der Regelzone Baden-Württemberg ausgegeben. Weitere Detailinformationen zur Nutzung der API findest du in der API-Dokumentation.
Warum muss ich bei API-Anfragen meinen Standort angeben?
Wir benötigen deinen ungefähren Standort, um dir korrekte Daten liefern zu können. Anfragen zu Standorten außerhalb von Baden-Württemberg können wir nicht bedienen, da TransnetBW nur für die Regelzone Baden-Württemberg zuständig ist. Ferner möchten wir deinen ungefähren Standort für Analysezwecke erfahren, da uns interessiert, wo in Baden-Württemberg die StromGedacht-Daten verarbeitet werden. Die Standortangabe in Form einer Postleitzahl sollte einen hinreichenden Schutz deiner Identität gewährleisten. Solltest du trotzdem deinen Standort nicht angeben wollen, dann nutze gerne die Postleitzahl der Zentrale der TransnetBW GmbH (PLZ: 70173).
Wie kann ich auf die API zugreifen?
Die API wurde mit dem gängigen Werkzeug Swagger
entwickelt und dokumentiert. Wir stellen dir hier eine entsprechende Oberfläche bereit, die du zum Kennenlernen der API nutzen kannst. Daneben kannst du natürlich auch programmatisch, beispielsweise über einen entsprechenden Python-Code, auf die API zugreifen. Schaue dir dazu gerne unsere Programmierbeispiele an.
Gibt es Programmierbeispiele?
Ja, wir stellen dir in unserem Leitfaden drei kleine Programmierbeispiele in den Sprachen Python und R als Starthilfe zur Verfügung.
Wie kann ich die StromGedacht-API in meinem Unternehmen / meiner Organisation verwenden?
Wir stellen die Daten der StromGedacht-API auch im Rahmen einer B2B-API Unternehmen und Organisationen zur Verfügung, die in Baden-Württemberg ansässig sind.
Bei Interesse an einer solchen Kooperation, stellen Sie gerne eine Anfrage an [email protected].
Soll ich während einer SUPERGRÜN-Phase Verbraucher ansteuern, die ich derzeit nicht brauche?
Nein. Du solltest nie mehr Energie verbrauchen als du brauchst. Bei einem Überschuss an erneuerbaren Energien wird dieser genutzt, um Pumpkraftwerke aufzufüllen oder er wird anderen EU-Ländern zur Verfügung gestellt.
Du kannst deinen Verbrauch jedoch anpassen und zum Beispiel die Spülmaschine bewusst in einer supergrünen Phase laufen lassen.
Warum gibt es für meine Postleitzahl keine Daten?
Bei Abruf der StromGedacht-Programmierschnittstelle (API) wird für folgende Postleitzahlen kein Wert geliefert:
64754, 69434, 71332, 71336, 71364, 71397, 71404, 71409, 71522, 71540, 71546, 71549, 71554, 71560, 71563, 71566, 71570, 71573, 71576, 71696, 71711, 71717, 71720, 71723, 71726, 71729, 71737, 73663, 74199, 74206, 74211, 74223, 74232,74257, 74360, 74379, 74385, 74388, 74394, 74395.
Das liegt daran, dass die Regelzone der TransnetBW (also der Teil des Übertragungsnetzes, für den TransnetBW zuständig ist) nicht exakt mit dem Bundesland Baden-Württemberg übereinstimmt. Die aufgeführten Postleitzahlen zählen zur Regelzone des Übertragungsnetzbetreibers Amprion. TransnetBW stellt das StromGedacht-Signal nur für die Gebiete zur Verfügung, die in ihrem Verantwortungsbereich liegen.