Achtung: veraltete API Definition – neue Dokumentation unter:
|
Die EnVKV API bietet einen Dienst zur Berechnung der seit dem 01.12.2011 notwendigen Energieverbrauchswerte und Effizienzklassen Darstellung bei Neu-PKW Angeboten. Es besteht die Möglichkeit zur Rückgabe der berechneten Werte auf Grund von fahrzeugspezifischen Grundwerten, so wie die Erstellung einer DinA4 PKW Label PDF Datei.
Falls Sie nur einige wenige Verbrauchsdatenblätter erstellen müssen, empfehlen wir Ihnen die direkte Eingabe bei www.pkw-label.de. Die EnVKV API ist für eine automatisierte Berechnung zwischen Webseiten bzw. Apps ausgelegt.
Die API verwendet die REST Architektur und liefert ihre Antworten im JSON Format aus bzw. im Fall des PKW Labels wird bei erfolgreicher Bearbeitung direkt ein PDF File on-the-fly erzeugt und dargestellt. Die Ausgabe kann dann vom anfragenden System entsprechend weiterverarbeitet bzw. die PDF Datei gespeichert werden.
https://envkv.54grad.de/api/
Folgende Anfragen sind möglich.
POST pkwlabel | Erstellung des PKW Labels als DinA4 PDF, wenn alle EnVKV Werte vorhanden sind. |
Ermittlung der CO2 Effizienzklasse. Einzelabfrage, sofern nicht data verwendet wird. | |
POST tax | Ermittlung der zu erwartenden KFZ Steuer im ersten Zulassungsjahr. Einzelabfrage, sofern nicht data verwendet wird. |
GET energiekosten | Abfrage der derzeit im System unterstützten Kraftstoffe mit den vom Bundeswirtschaftsministerium zuletzt gemeldeten Durchschnittspreisen. |
POST energiekosten | Ermittlung der Energieträgerkosten bei 20.000km Laufleistung. Einzelabfrage, sofern nicht data verwendet wird. |
POST data | Zusammenfassende Berechnung der EnVKV Werte, welche die Abfragen effizienzklasse, tax und energiekosten in einer Abfrage ermöglicht. |
Für die Nutzung der EnVKV API ist ein API Key notwendig. Bitte setzen Sie sich für weitere Informationen über das Kontaktformular mit uns in Verbindung.
Anfragen ohne API Key an vorhandene Resourcen werden mit einem 401 Authorization Required Header und einer JSON Statusmeldung beantwortet.
Antwort |
{ "statuscode":401, "status":"Authorization Required" } |
In der Client-Beispiele Sammlung sehen Sie Möglichkeiten, wie die EnVKV API abgefragt werden kann.