CarbonTrace REST API

Reliez les données des appareils à des calculs carbone traçables

Reliez votre catalogue de reconditionnement, inventaire ITAD ou portail client aux estimations du cycle de vie par appareil. Transmettez la configuration disponible et les hypothèses d’utilisation, puis conservez la méthode et les sources retournées avec le résultat.

URL de base: https://carbontrace.cloud/api/v1

Examinez les preuves avant d’utiliser un résultat

Le moteur v4 conserve les phases fabricant étayées ou utilise des estimations explicitement modélisées. Vérifiez la correspondance exacte de l’appareil, la durée de service, le périmètre et les limites des sources. Une empreinte de cycle de vie fabricant n’est pas automatiquement un facteur de fabrication seul. Les preuves manquantes restent visibles ; les plages de sensibilité ne sont pas des intervalles de confiance statistiques.

Les comparaisons de réemploi sont des écarts modélisés par rapport à une référence d’achat neuf précisée. Elles ne prouvent pas des émissions réellement évitées et ne doivent pas être déduites des totaux d’inventaire. Conservez les entrées, hypothèses et preuves avec les résultats clients.

Authentification

Certains endpoints de calcul acceptent les requêtes anonymes dans les limites publiques. Les données d’organisation, certificats et intégrations nécessitent l’authentification indiquée pour chaque endpoint. Créez une clé API dans votre compte et envoyez-la dans l’en-tête Authorization ; gardez les clés de production sur votre serveur.

Authorization: Bearer ct_your_api_key_here

Limites de requêtes

Les limites dépendent de l’offre actuelle de l’organisation, de la clé API et de l’endpoint. Les en-têtes de réponse indiquent la limite applicable et le quota restant. Consultez les offres actuelles sur la page des tarifs ; une liste fixe d’offres ne constitue pas un contrat API.

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

En cas de HTTP 429, attendez la durée indiquée par Retry-After avant de réessayer.

Voir les offres actuelles

Spécification OpenAPI

Utilisez la spécification lisible par machine pour générer du code, importer dans Postman ou utiliser Swagger UI. Chemins, champs, schémas de réponse et descriptions techniques restent en anglais pour correspondre au contrat API.

Télécharger le JSON

Tester avec des données synthétiques

Utilisez une clé API sandbox pour les endpoints pris en charge, avec des jeux de données déterministes. Ces réponses testent l’intégration ; ce ne sont ni des mesures d’appareils ni des preuves carbone client. Vérifiez l’authentification et la prise en charge sandbox de chaque endpoint avant l’envoi.

Créez une clé sandbox dans les paramètres des clés API de votre compte. Envoyez-la avec le même en-tête Authorization qu’une clé de production. Vérifiez l’indicateur sandbox avant d’afficher ou de stocker les résultats de test.

Gérer les clés API
Authorization: Bearer ct_test_...
X-CarbonTrace-Mode: sandbox

Extrait de réponse synthétique

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

Référence technique en anglais

Les noms d’endpoints, descriptions, paramètres et exemples de code ci-dessous proviennent de la spécification OpenAPI. Ils restent en anglais pour permettre une comparaison directe avec les champs de requête et de réponse de l’API.

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.