Ermittelt die Energieträgerkosten bei 20.000km Laufleistung, welche z.B. für die Darstellung im PKW Label benötigt werden. Hierbei wird auf die vom Finanzministerium veröffentlichten Durchschnittspreise für Kraftstoffe (PDF) zurückgegriffen. Diese sollen vom Bundesamt alle 12 Monate zum Juli hin aktualisiert werden. Sofern noch kein offizieller Durchschnittspreis für den gewählten Kraftstoff vorhanden ist, muss im PKW Label keine Berechnung der Energieträgerkosten erfolgen. Dies trifft derzeit z.B. bei den Wasserstoffkosten zu.

Resource URL

https://envkv.54grad.de/api/energiekosten

Parameter

POST Parameter mit dem Hinweis „required“ sind zwingend mit gültigen Daten zu übermitteln, da es sonst zu einem Abbruch der Berechnung kommen wird. Mehr Infos finden Sie in der jeweiligen Parameterbeschreibung und unter Antwort bei Fehlern.

kraftstoff
required
string Der empfohlene Kraftstoff (oder Kurzbezeichnung) des Herstellers. Bei bivalenten Fahrzeugen der Kraftstoff mit dem geringsten CO2 Ausstoß.
Mögliche Werte, fett = Preis vorhanden (Stand 07/2014):

Normal/Benzin
Super
Super Plus
Normal/Benzin E10
Super E10
Super Plus E10
Diesel
Biodiesel
Ethanolkraftstoff (E85)
Autogas (LPG)
Erdgas H
Erdgas L
Biomethan H
Biomethan L
Pflanzenöl
Strom
Wasserstoff
normal
super
superplus
normale10
supere10
superpluse10
diesel
biodiesel
e85
lpg
erdgash
erdgasl
biomethanl
biomethanh
pflanzenoel
strom
wasserstoff

Beispiel: supere10

verbrauch
required
float Kombinierter Kraftstoffverbrauch auf 100km. Bei bivalenten Fahrzeugen die Antriebsart mit dem geringsten CO2 Ausstoß.
Beispiel: 7.2 (oder 7,2 als string)

Beispiel Anfrage

POST
https://envkv.54grad.de/api/energiekosten
POST-Data
kraftstoff=supere10&verbrauch=7.2
Antwort
{
    "statuscode":201,
    "status":"CREATED",
    "energiekosten_kraftstoffname":"Super E10",
    "energiekosten_einheit":"l",
    "energiekosten_einzelpreis":1.530,
    "energiekosten_gesamt":2203.20
}

Antwort bei Fehlern

Sollte es zu Fehlern bei der Verarbeitung kommen, wird das Feld ’status‘ der JSON Antwort die Fehlermeldung enthalten. Der gesendete HTTP-Response-Header ist dann 400.

Antwort
{
    "statuscode":400,
    "status":"Kraftstoffart unbekannt oder nicht vorhanden."
}

EnVKV API Grundlagen

Weitere Informationen entnehmen Sie bitte der Hauptübersicht: API Grundlagen