POST effizienzklasse

Achtung: veraltete API Definition – neue Dokumentation unter:
https://api.pkwlabel.com/docs
mit 5 neuen PKW Labels der Gesetzesnovelle 2024

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