tounify-API
Aktuelle Daten durch intelligente Automatisierung
tounify sammelt automatisiert die Stromtarif-Daten von einer Vielzahl an Anbietern in ganz Europa.
Die eingebaute Intelligenz erlernt die Tarifinformationsseiten der statischen Tarife und kommuniziert kontinuierlich mit den Schnittstellen der dynamischen Tarife. Dadurch können die aktuellsten Daten über die tounify-API zur Verfügung gestellt werden.
Die Einbindung in Ihr System erfolgt mit ein paar Zeilen Code.
1. Token erhalten
Um die tounify-API verwenden zu können, schreiben Sie uns einfach eine kurze E-Mail mit Ihrem Namen und Ihren Produkten / Verwendungszwecken. Wir stellen Ihnen dann einen personalisierten Token für Ihr Unternehmen zur Verfügung.
Der Token muss bei allen Transaktionen im Header als “Authorization: Bearer TOKEN” mitgesendet werden.
2. Energieversorger auflisten
Um eine Liste der Energieversorger zu erhalten, die Time-of-use-Tarife anbieten, stellen Sie ein GET request an:
https://api.tounify.io/v1/energySuppliers?country=COUNTRY_CODE
Der COUNTRY_CODE (im ISO 3166-1 alpha-2 format) kann optional als Request-Parameter hinzugefügt werden, um nur die in diesem Land tätigen Energieversorger aufzulisten. Die Antwort wird im JSON-Format ausgegeben:
[
{
"id": "ESID1",
"name": "Energy Supplier 1",
"country": "AT"
},
...
{
"id": "ESID17",
"name": "Energy Supplier 2",
"country": "DE"
}
]
3. Energietarife auflisten
Um eine Liste der Time-of-use-Energietarife zu erhalten, stellen Sie ein GET request an:
https://api.tounify.io/v1/energyTariffs?country=COUNTRY_CODE&esid=ES_ID
Der COUNTRY_CODE und ES_ID kann optional als Request-Parameter hinzugefügt werden, um nur die in diesem Land oder dieses Energieversorger verfügbaren Energietarife aufzulisten. Die Antwort wird im JSON-Format ausgegeben:
[
{
"id": "ETID1",
"name": "Tariff Name 1",
"esid": "ESID1",
"country": "AT",
"link": "https://www.energy-utility.com/tariff-name1"
},
...
{
"id": "ETID3",
"name": "Tariff Name 2",
"esid": "ESID17",
"country": "DE",
"link": "https://www.energy-utility.com/tariff-name2"
}
]
4. Netzbetreiber auflisten
Um eine Liste der verfügbaren Netzbetreiber (DSOs) zu erhalten, stellen Sie ein GET request an:
https://api.tounify.io/v1/dsos?country=COUNTRY_CODE
Der COUNTRY_CODE (in ISO 3166-1 alpha-2 format) kann optional als Request-Parameter hinzugefügt werden, um nur die in diesem Land tätigen DSOs aufzulisten. Die Antwort wird im JSON-Format ausgegeben:
[
{
"id": "DSOID1",
"name": "Distribution System Operator 1",
"country": "AT"
},
...
{
"id": "DSOID17",
"name": "Distribution System Operator 2",
"country": "DE"
}
]
5. Netztarife auflisten
Um eine Liste der Time-of-use-Netztarife zu erhalten, stellen Sie ein GET request an:
https://api.tounify.io/v1/gridTariffs?country=COUNTRY_CODE&dsoid=DSO_ID
Der COUNTRY_CODE und DSO_ID kann optional als Request-Parameter hinzugefügt werden, um nur die in diesem Land oder dieses DSOs verfügbaren Netztarife aufzulisten. Die Antwort wird im JSON-Format ausgegeben:
[
{
"id": "GTID1",
"name": "Tariff Name 1",
"description": "Description of grid tariff details",
"dsoid": "DSOID1",
"country": "AT",
"link": "https://www.energy-utility.com/tariff-name1"
},
...
{
"id": "GTID3",
"name": "Tariff Name 2",
"description": "Description of grid tariff details",
"dsoid": "DSOID17",
"country": "DE",
"link": "https://www.energy-utility.com/tariff-name2"
}
]
6. und zuletzt: Day-Ahead-Preise anzeigen
Day-Ahead-Preise für die meisten Tarife sind gegen Mittag verfügbar. Stellen Sie die folgende GET-Anfrage, um die Preise für den verfügbaren Zeithorizont abzurufen:
https://api.tounify.io/v1/dayahead?es_tariff=ET_ID&dso_tariff=GT_ID
Die ET_ID und GT_ID sind die in den vorherigen Schritten 3 und 5 angegebenen Tarif-IDs. Wenn sowohl Energie- als auch Netz-Tarif-IDs angegeben werden, ist der Preis im Wertearray die Summe aus Energie- und Netzpreis. Die Antwort wird im JSON-Format ausgegeben:
{
"es_tariff": "ETID1",
"dso_tariff": "GTID1",
"from_utc": 1605636000,
"unit": "ct/kWh",
"step": 60,
"next": 1605639624,
"values": [
4.4,
4.43,
...
2.36
]
}
step ist das Zeit-Inkrement in Minuten zwischen jedem Preiswert.
next ist der UTC-Zeitstempel bei dem empfohlen wird die nächste Preisinformationen abzurufen