Una consulta.
Traza de auditoría completa.
Obtén activos, productos, cálculos, factores de emisión y su registro de fuentes en un solo viaje de ida y vuelta. Diseñado para auditores CSRD, paneles de BI e integraciones con LLM que necesitan todo el grafo.
Nativo de grafo
Activo → producto → cálculo → factor → registro recorridos en una sola consulta, no en cinco.
Apto para auditoría
Cada cálculo enlaza con el factor que estaba activo en el momento del cálculo, con la procedencia completa de la fuente.
Mutaciones de escenario
Simula el reacondicionamiento o la retirada sin tocar la base de datos. Seguro en activos bloqueados y certificados.
Inicio rápido
Usa cualquier clave de API desde tu página de ajustes. Las claves de prueba (ct_test_*) devuelven datos de sandbox para que puedas desarrollar sin tocar los datos reales.
curl -X POST https://carbontrace.cloud
/api/v1/graphql \
-H "Authorization: Bearer ct_test_..." \
-H "Content-Type: application/json" \
-d '{
"query": "query { organization { name plan asset_count total_kg_co2e } }"
}'Consultas de ejemplo
Cada ejemplo a continuación está preaprobado en los planes free y pro (lista blanca de consultas persistidas). Los planes business y enterprise pueden enviar consultas personalizadas.
Recorrido de la metodología
Una sola llamada para la traza de auditoría completa. Activo → cálculo → factor de red → registro de fuentes. Diseñado para auditores CSRD.
query MethodologyAudit($assetId: ID!) {
asset(id: $assetId) {
id
brand
mpn
total_kg_co2e
production_kg
use_phase_kg
active_calculation {
id
created_at
total_kg_co2e
emission_factor(type: GRID) {
value
unit
source
source_version
source_url
source_license
registry {
display_name
current_version
next_check_after
}
}
}
}
}Detalle del activo
Obtén un activo con su producto vinculado y una coincidencia opcional en el catálogo global (datos PCF si están disponibles).
query AssetDetail($id: ID!) {
asset(id: $id) {
id
brand
mpn
serial_number
status
purchase_date
country
total_kg_co2e
product {
id
brand
mpn
name
category
catalogMatch {
has_pcf
pcf_total_kg
pcf_standard
pcf_year
}
}
}
}Resumen de la organización
Resumen actual de la organización con el número de activos y el total de CO₂e contabilizado.
query OrgOverview {
organization {
id
name
plan
asset_count
total_kg_co2e
}
}Factor por región + fecha
Consulta el factor de red que estaba activo para una región en una fecha concreta. La misma primitiva que utiliza internamente el recorrido de la metodología.
query FactorLookup($region: String!, $atDate: DateTime) {
factorByRegion(type: GRID, regionCode: $region, atDate: $atDate) {
value
unit
source
source_version
valid_from
valid_to
}
}Simular reacondicionamiento (mutación)
Escenario hipotético: extender la vida útil en lugar de reemplazar. Cálculo puro — no se escribe nada en la base de datos.
mutation Refurbish($ids: [ID!]!) {
simulateRefurbish(assetIds: $ids) {
current_quarterly_co2e
scenario_quarterly_co2e
delta_kg_co2e
delta_percentage
affected_assets_count
}
}Límites y trampas
- Los límites de tasa se comparten con la API REST — los mismos cupos por minuto y por día según el plan. Free: 25/day, Pro: 1000/day, Business: 10000/day, Enterprise: 100000/day.
- Los planes free y pro solo pueden ejecutar consultas de la lista blanca (las 5 anteriores). Business y enterprise pueden enviar cualquier consulta.
- Las consultas de activos devuelven un máximo de 100 filas por página. Usa el cursor
afterpara la paginación. - Las mutaciones de escenario tienen un límite de 500 activos por llamada. Las carteras más grandes deben dividirse en lotes en el cliente.
Referencia completa
La API REST sigue siendo la superficie principal. GraphQL está pensada para lecturas en forma de grafo y escenarios hipotéticos.