GraphQL API

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.

POST https://carbontrace.cloud/api/v1/graphql

Nativo de grafo

Activo → producto → cálculo → factor → registro recorridos en una sola consulta, no en cinco.

Referencias de origen guardadas

Las fichas conservan entradas y supuestos. Un factor original solo se vincula si su identificador guardado es inequívoco; la procedencia ausente devuelve null.

Mutaciones de escenario

Simule reacondicionamiento con igual servicio o apagado en el próximo trimestre. El inventario no cambia; la ejecución queda registrada.

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 OrgOverview { organization { id 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

Consulte activo, cálculo y referencias eléctricas guardadas disponibles. Un enlace al registro no acredita verificación independiente.

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
    }
  }
}

Resumen de la organización

Totales actuales del ciclo de vida de los activos; no son automáticamente un inventario de un período de información.

query OrgOverview {
  organization {
    id
    name
    plan
    asset_count
    total_kg_co2e
  }
}

Factor por región + fecha

Consulta de referencia por región y fecha; no demuestra que un factor se usara en un cálculo guardado.

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)

Compare una compra nueva y un reacondicionamiento durante el mismo próximo trimestre. La producción original ya ocurrió; el fin de vida común se excluye.

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 after para 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.
Consulte methodology_card, boundary y assumptions cuando estén disponibles. El motor v4 usa tratamiento bruto modelizado al final de vida, escenarios de recuperación separados y sensibilidad no estadística. Un delta negativo implica menos emisiones estimadas, no una deducción del inventario. Añadir campos a las cinco plantillas requiere una consulta aprobada o un plan ad hoc.

Referencia completa

La API REST sigue siendo la superficie principal. GraphQL está pensada para lecturas en forma de grafo y escenarios hipotéticos.

Documentación de la API REST ¿Nuevo en GraphQL?

Una consulta.Traza de auditoría completa.