CarbonTrace REST API

Verbind toesteldata met herleidbare carbonberekeningen

Koppel uw refurbishercatalogus, ITAD-inventaris of klantportaal aan levenscyclusramingen per toestel. Geef de beschikbare configuratie en gebruiksaannames mee en bewaar de teruggeleverde methode en broninformatie bij het resultaat.

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

Beoordeel het bewijs voordat u een resultaat gebruikt

Engine v4 behoudt onderbouwde fabrikantfasen of gebruikt expliciete modelschattingen. Controleer de exacte toestelmatch, gebruiksduur, levenscyclusgrens en bronproblemen. Een levenscyclusvoetafdruk van de fabrikant is niet automatisch een factor voor alleen fabricage. Ontbrekend bewijs blijft zichtbaar; gevoeligheidsbanden zijn geen statistische betrouwbaarheidsintervallen.

Hergebruiksvergelijkingen zijn gemodelleerde verschillen tegenover een benoemde nieuwkoopreferentie. Ze bewijzen geen feitelijk vermeden uitstoot en mogen niet van inventaristotalen worden afgetrokken. Bewaar invoer, aannames en bewijs bij ieder klantresultaat.

Authenticatie

Sommige rekenendpoints accepteren anonieme verzoeken binnen publieke limieten. Organisatiegegevens, certificaten en integraties vereisen de bij het endpoint aangegeven authenticatie. Maak een API-sleutel in uw account en stuur die mee in de Authorization-header; bewaar productiesleutels op uw server.

Authorization: Bearer ct_your_api_key_here

Verzoeklimieten

Limieten hangen af van het actuele organisatiepakket, de API-sleutel en het endpoint. Responseheaders vermelden de geldende limiet en resterende ruimte. De prijspagina toont de actuele pakketconfiguratie; een vaste lijst pakketnamen is geen API-contract.

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

Wacht bij HTTP 429 de in Retry-After vermelde periode voordat u opnieuw probeert.

Bekijk actuele pakketten

OpenAPI-specificatie

Gebruik de machineleesbare specificatie voor codegeneratie, Postman of Swagger UI. Paden, veldnamen, responseschema’s en technische beschrijvingen blijven Engels zodat ze overeenkomen met het API-contract.

JSON downloaden

Testen met synthetische gegevens

Gebruik een sandbox-API-sleutel voor ondersteunde endpoints met vaste testgegevens. Deze antwoorden testen uw integratie; het zijn geen toestelmetingen of carbonbewijzen voor klanten. Controleer de authenticatie en sandboxondersteuning van ieder endpoint vóór een verzoek.

Maak een sandboxsleutel in de API-sleutelinstellingen van uw account. Stuur die mee via dezelfde Authorization-header als een productiesleutel. Controleer de sandboxmarkering voordat u testresultaten toont of opslaat.

API-sleutels beheren
Authorization: Bearer ct_test_...
X-CarbonTrace-Mode: sandbox

Fragment van een synthetisch antwoord

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

Engelse technische referentie

De volgende endpointnamen, beschrijvingen, parameters en codevoorbeelden komen uit de OpenAPI-specificatie. Ze blijven Engels om rechtstreeks met de verzoek- en antwoordvelden van de API te kunnen vergelijken.

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.