POST effizienzklasse
Achtung: veraltete API Definition – neue Dokumentation unter:
|
Ermittelt die CO2 Effizienzklasse, welche für die Darstellung im PKW Label benötigt wird. Hierbei wird auf die vom Bundesministerium für Wirtschaft und Technologie veröffentlichte Formel zur Berechnung der Energieeffizienzklasse in § 3a der PKW-EnVKV zurückgegriffen. Bitte beachten Sie, dass für die Berechnung nicht das Leergewicht, sondern die Masse des fahrbereiten Fahrzeuges in kg benötigt wird (COC).
Resource URL
https://envkv.54grad.de/api/effizienzklasse
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.
| masse required |
int | Masse des fahrbereiten Fahrzeuges in ganzen Kilogramm (COC) Beispiel: 1448 |
| co2 required |
int / string | Kombinierter CO2 Ausstoß in g/km. Bei bivalenten Antrieben der Kraftstoff mit dem geringsten CO2 Ausstoß. Bei Antrieben ohne CO2 Ausstoß als Wert ‚entfaellt‘ verwenden, da der Wert 0 einen Fehler zurück gibt. Beispiel: 148 Beispiel: entfaellt |
Hinweis: Bei Angeboten, die nur noch WLTP Verbrauchswerte ausgewiesen haben, kann keine Effizienzklasse berechnet werden. Hier darf NICHT der wltp_co2 Wert genommen werden, sondern das PKW Label wird leer erstellt.
Beispiel Anfrage
| POST |
https://envkv.54grad.de/api/effizienzklasse |
| POST-Data |
masse=1448&co2=148 |
| Antwort |
{
"statuscode":201,
"status":"CREATED",
"effizienzklasse":"C"
}
|
Beispiel Anfrage: reines Elektromobil
| POST |
http://envkv.54grad.de/api/effizienzklasse |
| POST-Data |
masse=1448&co2=entfaellt |
| Antwort |
{
"statuscode":201,
"status":"CREATED",
"effizienzklasse":"A+"
}
|
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":"CO2 in g/km fehlt oder ist fehlerhaft."
}
|
EnVKV API Grundlagen
Weitere Informationen entnehmen Sie bitte der Hauptübersicht: API Grundlagen