CarbonTrace REST API

Gerätedaten mit nachvollziehbaren CO₂‑Berechnungen verbinden

Verbinden Sie Ihren Refurbisher-Katalog, ITAD-Bestand oder Ihr Kundenportal mit Lebenszyklusschätzungen je Gerät. Übermitteln Sie die verfügbare Konfiguration und Nutzungsannahmen und bewahren Sie die zurückgegebene Methode und Quellen mit dem Ergebnis auf.

Basis-URL: https://carbontrace.cloud/api/v1

Prüfen Sie die Nachweise vor der Verwendung eines Ergebnisses

Engine v4 übernimmt belegte Herstellerphasen oder nutzt offengelegte Modellschätzungen. Prüfen Sie die genaue Geräteübereinstimmung, Nutzungsdauer, Systemgrenze und Quellenlücken. Ein Herstellerwert für den gesamten Lebenszyklus ist nicht automatisch ein reiner Herstellungsfaktor. Fehlende Nachweise bleiben sichtbar; Sensitivitätsbereiche sind keine statistischen Konfidenzintervalle.

Wiederverwendungsvergleiche sind modellierte Unterschiede gegenüber einer benannten Neukaufreferenz. Sie belegen keine tatsächlich vermiedenen Emissionen und dürfen nicht von Inventarsummen abgezogen werden. Bewahren Sie Eingaben, Annahmen und Nachweise mit den Kundenergebnissen auf.

Authentifizierung

Einige Berechnungsendpunkte akzeptieren anonyme Anfragen innerhalb öffentlicher Limits. Organisationsdaten, Zertifikate und Integrationen benötigen die am Endpunkt angegebene Authentifizierung. Erstellen Sie einen API-Schlüssel in Ihrem Konto und senden Sie ihn im Authorization-Header; speichern Sie Produktionsschlüssel auf Ihrem Server.

Authorization: Bearer ct_your_api_key_here

Anfragelimits

Limits hängen vom aktuellen Organisationspaket, API-Schlüssel und Endpunkt ab. Die Antwortheader nennen das geltende Limit und verbleibende Kontingent. Aktuelle Pakete stehen auf der Preisseite; eine feste Liste von Paketnamen ist kein API-Vertrag.

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Plan

Warten Sie bei HTTP 429 die in Retry-After angegebene Zeit vor einer erneuten Anfrage.

Aktuelle Pakete ansehen

OpenAPI-Spezifikation

Nutzen Sie die maschinenlesbare Spezifikation für Codegenerierung, Postman oder Swagger UI. Pfade, Feldnamen, Antwortschemata und technische Beschreibungen bleiben auf Englisch, damit sie dem API-Vertrag entsprechen.

JSON herunterladen

Mit synthetischen Daten testen

Testen Sie unterstützte Endpunkte mit einem Sandbox-API-Schlüssel und festen Testdaten. Diese Antworten prüfen Ihre Integration; sie sind keine Gerätemessungen oder CO₂-Nachweise für Kunden. Prüfen Sie vor der Anfrage die Authentifizierung und Sandbox-Unterstützung des jeweiligen Endpunkts.

Erstellen Sie einen Sandbox-Schlüssel in den API-Schlüsseleinstellungen Ihres Kontos. Senden Sie ihn mit demselben Authorization-Header wie einen Produktionsschlüssel. Prüfen Sie die Sandbox-Kennzeichnung, bevor Sie Testergebnisse anzeigen oder speichern.

API-Schlüssel verwalten
Authorization: Bearer ct_test_...
X-CarbonTrace-Mode: sandbox

Auszug einer synthetischen Antwort

{
  "product": { "brand": "SandboxCorp", "mpn": "TEST-001", "category": "laptop" },
  "_sandbox": true
}

Englische technische Referenz

Die folgenden Endpunktnamen, Beschreibungen, Parameter und Codebeispiele stammen aus der OpenAPI-Spezifikation. Sie bleiben auf Englisch, damit sie direkt mit den Anfrage- und Antwortfeldern der API vergleichbar sind.

25 matching endpoints

Footprint

Calculate lifecycle carbon footprints for IT devices

Products

Search and identify products via built-in database and Icecat

Certificates

Generate and download verifiable CO₂ impact certificates

Reports

Generate sustainability and hotspot analysis PDF reports

Reference

Countries, grid factors, and device categories

Integrations

Third-party platform integrations (Blancco)

Export

Async org-wide GDPR bulk export jobs

BI Export

OData v4 read-only endpoint for Power BI, Tableau, and Excel. Enterprise-only. Every response is signed with a hash-linked proof header tied to the CarbonTrace audit log. See /docs/bi-export for setup instructions.

ReVend

Server-to-server contract: idempotent async job submit, status/results, key/status, and signed per-job webhooks. API-key auth; carbon-only payloads.