ENVKV Labels API Dokumentation

Generieren Sie Fahrzeug-Labels für verschiedene Antriebstypen

Übersicht

Die ENVKV Labels API ermöglicht es Ihnen, Fahrzeug-Labels für verschiedene Antriebstypen zu generieren.

Basis-URL: https://api.cardatas.com/api-v1/

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel, der im Header mitgesendet werden muss.

Header: X-API-Key: <Ihr-API-Schlüssel>

Um einen API-Schlüssel zu erhalten, kontaktieren Sie bitte support@cardatas.com.

Endpunkte

Generiere PKW-Label

URL: /pkwlabel

Methode: POST

Content-Type: application/json

Anforderungsstruktur

Die Anforderungsstruktur variiert je nach Antriebstyp des Fahrzeugs. Hier sind die verfügbaren Antriebstypen:

Beispielanfragen

COMBUSTION (Verbrennungsmotor)

{
  "driveType": "COMBUSTION",
  "driveSubType": "PETROL",
  "marke": "Volkswagen",
  "modell": "Golf",
  "fin": "WVWZZZ1KZAM654321",
  "leitfaden": "https://www.dat.de/co2/",
  "energieverbrauchKombiniert": 6.5,
  "co2Emissionen": 148,
  "hubraum": 1984,
  "kraftstoffverbrauchKombiniert": 6.5,
  "kraftstoffverbrauchInnenstadt": 8.2,
  "kraftstoffverbrauchCity": 7.8,
  "kraftstoffverbrauchRural": 5.9,
  "kraftstoffverbrauchHighway": 5.6
}

NATURAL_GAS (Erdgas)

{
  "driveType": "NATURAL_GAS",
  "marke": "Audi",
  "modell": "A3 g-tron",
  "fin": "WAUZZZ8VXKA123456",
  "leitfaden": "https://www.dat.de/co2/",
  "energieverbrauchKombiniert": 3.5,
  "co2Emissionen": 96,
  "hubraum": 1498,
  "kraftstoffverbrauchKombiniert": 3.5,
  "kraftstoffverbrauchInnenstadt": 4.1,
  "kraftstoffverbrauchCity": 3.9,
  "kraftstoffverbrauchRural": 3.3,
  "kraftstoffverbrauchHighway": 3.2
}

HYBRID (Hybridantrieb)

{
  "driveType": "HYBRID",
  "driveSubType": "PLUG_IN_HYBRID",
  "marke": "BMW",
  "modell": "330e",
  "fin": "WBA5A3C08KD123456",
  "leitfaden": "https://www.dat.de/co2/",
  "energieverbrauchGewichtetKombiniert": 1.7,
  "kraftstoffverbrauchGewichtetKombiniert": 1.7,
  "co2EmissioneGewichtetKombiniert": 39,
  "co2EmissionenKombiniertBeiEntladenerBatterie": 142,
  "co2Emissionen": 39,
  "electricRange": 59,
  "hubraum": 1998,
  "kraftstoffverbrauchKombiniert": 6.1,
  "kraftstoffverbrauchInnenstadt": 7.2,
  "kraftstoffverbrauchCity": 6.8,
  "kraftstoffverbrauchRural": 5.7,
  "kraftstoffverbrauchHighway": 5.4,
  "stromVerbrauchKombiniert": 15.0,
  "stromVerbrauchInnerstadt": 16.5,
  "stromVerbrauchCity": 15.8,
  "stromVerbrauchRural": 14.2,
  "stromVerbrauchHighway": 13.5
}

ELECTRIC (Elektroantrieb)

{
  "driveType": "ELECTRIC",
  "marke": "Tesla",
  "modell": "Model 3",
  "fin": "5YJ3E1EA1KF123456",
  "leitfaden": "https://www.dat.de/co2/",
  "co2Emissionen": 0,
  "electricRange": 448,
  "stromVerbrauchKombiniert": 14.9,
  "stromVerbrauchInnerstadt": 15.8,
  "stromVerbrauchCity": 15.2,
  "stromVerbrauchRural": 14.5,
  "stromVerbrauchHighway": 14.2
}

FUEL_CELL (Brennstoffzelle)

{
  "driveType": "FUEL_CELL",
  "marke": "Toyota",
  "modell": "Mirai",
  "fin": "JTDBV3EA5L3123456",
  "leitfaden": "https://www.dat.de/co2/",
  "co2Emissionen": 0,
  "kraftstoffverbrauchKombiniert": 0.76,
  "kraftstoffverbrauchInnenstadt": 0.69,
  "kraftstoffverbrauchCity": 0.72,
  "kraftstoffverbrauchRural": 0.78,
  "kraftstoffverbrauchHighway": 0.82
}

Antwort

Die API antwortet mit einem PDF-Dokument, das das generierte Fahrzeug-Label enthält.

Fehlerbehandlung

Bei fehlenden oder ungültigen Daten wird die API mit einem entsprechenden Fehlercode und einer Fehlermeldung antworten, die die fehlenden oder ungültigen Felder auflistet.