BKV-API: Einführung

​

Basis-URL

https://api.otark.energy/v1

​

Authentifizierung

curl -X GET "https://api.otark.energy/v1/contracts" \
-H "X-Api-Key: IHR_API_KEY"

​

Datenmodell

Vertrag (PPA, etc.)
 └── Transaktion (vertragliche Energiemengen zwischen Käufer und Verkäufer)
       └── Nominierung (Saldo, aggregiert nach Bilanzkreis)

• Verträge repräsentieren Energievereinbarungen (z.B. PPAs) zwischen einem Verkäufer und einem Käufer. Verträge sind polymorph — das Schema variiert je nach Typ.
• Transaktionen repräsentieren die vertraglichen Energiemengen, die zwischen Käufer und Verkäufer im Rahmen eines Vertrags übertragen werden sollen. Transaktionen sind unveränderlich; Korrekturen erzeugen eine neue Version, die die vorherige ersetzt.
• Nominierungen sind der Netto-Saldo gültiger Transaktionen, aggregiert nach Bilanzkreis und Lieferzeitraum. Nominierungen sind ebenfalls versioniert.
• Kunden repräsentieren Energieverbraucher oder -erzeuger, die einem BKV zugeordnet sind. Zwei Kunden bilden jeweils die beiden Vertragsparteien eines Vertrags. Kunden können genehmigt, abgelehnt und mit Bilanzkreis-Einstellungen konfiguriert werden.

​

Erste Schritte

1. API-Schlüssel im BKV-Portal erstellen.
2. Verträge und Kunden erkunden mit GET /v1/contracts und GET /v1/customers.
3. Transaktionen einsehen für einen Vertrag mit GET /v1/contracts/{contract_id}/transactions.
4. Nominierungen prüfen mit GET /v1/nominations.

​

Support