CarbonTrace REST API

Conecte los datos de los dispositivos con cálculos de carbono trazables

Conecte su catálogo de reacondicionamiento, inventario ITAD o portal de clientes con estimaciones del ciclo de vida por dispositivo. Envíe la configuración disponible y las hipótesis de uso y conserve el método y las fuentes devueltos junto al resultado.

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

Revise las pruebas antes de utilizar un resultado

El motor v4 conserva las fases del fabricante respaldadas o utiliza estimaciones de modelo declaradas. Compruebe la coincidencia exacta del dispositivo, la vida útil, el alcance y las limitaciones de las fuentes. Una huella del ciclo de vida del fabricante no es automáticamente un factor solo de fabricación. Las pruebas ausentes permanecen visibles; los rangos de sensibilidad no son intervalos estadísticos de confianza.

Las comparaciones de reutilización son diferencias modeladas frente a una referencia declarada de compra nueva. No prueban emisiones realmente evitadas y no deben restarse de los totales de inventario. Conserve los datos de entrada, hipótesis y pruebas con los resultados destinados al cliente.

Autenticación

Algunos endpoints de cálculo aceptan solicitudes anónimas dentro de los límites públicos. Los datos de organización, certificados e integraciones requieren la autenticación indicada para cada endpoint. Cree una clave API en su cuenta y envíela en la cabecera Authorization; mantenga las claves de producción en su servidor.

Authorization: Bearer ct_your_api_key_here

Límites de solicitudes

Los límites dependen del plan actual de la organización, la clave API y el endpoint. Las cabeceras de respuesta indican el límite aplicable y el saldo disponible. Consulte los planes actuales en la página de precios; una lista fija de planes no es un contrato API.

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

Ante HTTP 429, espere el periodo indicado por Retry-After antes de reintentar.

Ver los planes actuales

Especificación OpenAPI

Utilice la especificación legible por máquina para generar código, importar en Postman o usar Swagger UI. Las rutas, campos, esquemas de respuesta y descripciones técnicas permanecen en inglés para coincidir con el contrato API.

Descargar JSON

Probar con datos sintéticos

Utilice una clave API sandbox para probar endpoints compatibles con datos de prueba deterministas. Estas respuestas prueban su integración; no son mediciones de dispositivos ni pruebas de carbono para clientes. Revise la autenticación y la compatibilidad sandbox de cada endpoint antes de enviar una solicitud.

Cree una clave sandbox en los ajustes de claves API de su cuenta. Envíela con la misma cabecera Authorization que una clave de producción. Compruebe el indicador sandbox antes de mostrar o guardar resultados de prueba.

Gestionar claves API
Authorization: Bearer ct_test_...
X-CarbonTrace-Mode: sandbox

Fragmento de respuesta sintética

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

Referencia técnica en inglés

Los nombres de endpoints, descripciones, parámetros y ejemplos de código siguientes proceden de la especificación OpenAPI. Permanecen en inglés para compararlos directamente con los campos de solicitud y respuesta de la 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.