POST energiekosten
Achtung: veraltete API Definition – neue Dokumentation unter:
|
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):
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) |
Hinweis: Bei Angeboten, die nur noch WLTP Verbrauchswerte ausgewiesen haben, kann kein Jahresgesamtpreis berechnet werden. Hier darf NICHT ein WLTP Verbrauchswert genommen werden. In diesem Fall das Feld verbrauch nicht übertragen. Es erfolgt dann ein Rückmeldung ohne das Feld energiekosten_gesamt.
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