API-Dokumentation für Steuerungs- und Datendienste

Im Förderprojekt WARAN hat das Konsortium verschiedene Anwendungsfälle in Wärmenetzen und im Stromnetz unter Einbindung des intelligenten Messsystems (iMSys) untersucht. Die betrachteten Anwendungsfälle und die dazugehörigen Systemarchitekturen sind hier aufgeführt und beschrieben. Ein Anwendungsfall der intensiver betrachtet wurde ist der Einsatz einer Hüllkurve/des Flexbands im Stromnetz. Dazu wurde unter anderem ein Impulspapier veröffentlicht, das das angestrebte Zielbild beschreibt.

Für die interoperable Umsetzung und branchenweite Akzeptanz vieler dieser Anwendungsfälle ist eine standardisierte API zwischen dem Messstellenbetreiber und den weiteren beteiligten Akteuren erforderlich. Im Schaubild rechts ist dies die "BDEW WEB API". Das Konsortium hat hierzu Vorschläge erarbeitet, die auf dieser Seite mit der Branche geteilt und zur Diskussion gestellt werden.

In einem ersten Schritt wurden Vorschläge für die Dienste „Ad-hoc API“, „Flexband“, „SR-Statuskonfigurationen“ und "EMS Daten API" entwickelt. Die Dienste sind aus Sicht des MSB beschrieben. Ist der MSB als API-Anbieter (Server) gekennzeichnet, stellt er den Endpunkt bereit; der berechtigte Marktpartner ruft diesen auf. Ist der MSB als API-Nutzer (Client) gekennzeichnet, stellt der empfangende Marktpartner, beispielsweise VNB oder LF, den Endpunkt bereit; der MSB ruft diesen auf. Rückmeldungen erfolgen als separate POST-Aufrufe an den jeweiligen Empfänger.

Die technischen Vorschläge orientieren sich an der API-Guideline sowie den Regelungen zum Übertragungsweg für API-Webdienste und zum Verzeichnisdienst von BDEW/EDI@Energy. Für die Bekanntgabe und Ermittlung der Zieladressen ist die Nutzung des dort beschriebenen Verzeichnisdienstes vorgesehen. Die zugrunde liegenden Dokumente sind unter https://bdew-mako.de/documents abrufbar.