Berechnungen werden pro Calculation Option abgerechnet. Erfahre darüber wie du dein Abrechnungs-Modell finden kannst.
Vorbereitung
Mache dich zunächst grundsätzlich damit vertraut, wie wir Emissionen berechnen.
API Key erstellen
Öffne im Dashboard das Entwickler-Menü und navigiere zum Punkt API Keys. Klicke nun auf Neue API Keys hinzufügen. Um Emissionen zu berechnen benötigen deine API Keys Schreiben-Berechtigungen.
Wichtig: Speichere dir den Secret Key gut ab und gebe ihn niemals an dritte weiter!
Passende Faktoren finden
Suche nun die für dich passenden Emissionsfaktoren aus unserer Datenbank. Du kannst pro Request an unsere API bis zu 100 sogenannte Calculation Options übergeben.
API anfragen
Nutze nun den Endpunkt /calculate
, um die Emissionen zu berechnen.
Gut zu wissen: Du kannst auch unsere PHP Library oder unsere Node.js Library nutzen, um mit der API zu interagieren.
Optionen
Calculation Options
Übergebe nun die von dir festgelegten calculation_options
an die API. Du kannst bis zu 100 calculation_options
gleichzeitig berechnen.
Fractional Digits
Standardmäßig runden wir die berechneten Emissionen immer zum nächstgrößeren Kilogram auf. Wenn du eine genauere Berechnung wünschst kannst du einfach fractional_digits
nutzen, um die maximale Anzahl der zurückgegebenen Nachkommastellen zu definieren.
Beispiel
In diesem Beispiel berechnen wir die Emissionen einer Fahrt von Berlin nach München.
POSThttps://api.klimapi.com/v2/calculate
1 2 3 4 5 6 7 8 9 10 11 12 13
{ "calculation_options": [ { "type": "travel-land", "activity": "cars_by_size", "specification": "small_car", "detail": "average", "departure": "Berlin, Germany", "destination": "Munich, Germany" } ], "fractional_digits": 2 }
Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
{ "kgCO2e": 71.23, "calculation_id": "CALC-0000-00000000", "results": [ { "type": "travel-land", "activity": "cars_by_size", "specification": "small_car", "detail": "average", "value": 586, "departure": "Berlin, Germany", "destination": "Munich, Germany", "kgCO2e": 71.23 } ] }