因子API：为您的软件提供英国及各国官方排放因子

使用方式

1. 登录并在应用中打开因子API。创建密钥并复制（仅显示一次）。
2. 在每个请求中以Authorization: Bearer crf_…的形式发送。
3. 读取data，并在显示数值的任何地方显示attribution文本。

curl -H "Authorization: Bearer $FACTOR_API_KEY" \
  "https://carbonrecycling.co.uk/api/v1/uk/factors?year=2026&q=diesel&category=fuels&scope=1"

密钥保存在您的服务器上，而不是网页中。API为只读（GET），以JSON格式响应，允许跨域请求，并有版本管理：任何会破坏您代码的更改都会放在新版本中，而不会放入v1。

端点参考

基础地址https://carbonrecycling.co.uk/api/v1。GET /api/v1无需密钥即可列出端点和来源。对于英国因子，year指DESNZ因子集（2002至2026，默认为最新）。对于按国家和美国区域划分的电力数据，year为您的报告年度，返回截至该年度的最新数据年份。

按ID查询英国因子

GET https://carbonrecycling.co.uk/api/v1/uk/factors/7_400_4000_5_1?year=2026

{
  "data": {
    "id": "7_400_4000_5_1",
    "year": 2026,
    "scope": "Scope 2",
    "category": "UK electricity",
    "path": ["UK electricity", "Electricity generated", "Electricity: UK", "kWh", null],
    "description": "UK electricity › Electricity generated › Electricity: UK › kWh",
    "unit": "kWh",
    "kgCo2ePerUnit": 0.13096
  },
  "attribution": [
    {
      "source": "desnz-factors",
      "name": "UK Government GHG Conversion Factors for Company Reporting",
      "publisher": "Department for Energy Security and Net Zero (DESNZ)",
      "licence": "Open Government Licence v3.0",
      "licenceUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
      "attribution": "Contains public sector information licensed under the Open Government Licence v3.0. Source: DESNZ, Greenhouse gas reporting: conversion factors."
    }
  ],
  "notice": "Figures as published by each source, supplied without warranty. Carbon Recycling is not endorsed by any of the publishers named in attribution.",
  "meta": { "year": 2026 }
}

英国电力，含剩余能源结构

GET https://carbonrecycling.co.uk/api/v1/uk/electricity?year=2026

{
  "data": {
    "year": 2026,
    "locationBased": { "id": "7_400_4000_5_1", "kgCo2ePerKwh": 0.13096, "scope": "Scope 2", "description": "UK electricity › ..." },
    "transmissionAndDistribution": { "id": "13_402_4000_5_1", "kgCo2ePerKwh": 0.01299, "scope": "Scope 3", "description": "..." },
    "wellToTank": {
      "generation": { "id": "15_917_4000_5_1", "kgCo2ePerKwh": 0.03682, "scope": "Scope 3", "description": "..." },
      "transmissionAndDistribution": { "id": "15_918_4000_5_1", "kgCo2ePerKwh": 0.00359, "scope": "Scope 3", "description": "..." }
    },
    "residualMix": { "kgCo2PerKwh": 0.396, "dataYear": 2025, "period": "1 April 2025 to 31 March 2026", "basis": "UK residual fuel mix, CO2 only, ..." }
  },
  "attribution": [ { "source": "desnz-factors", ... }, { "source": "desnz-fuel-mix", ... } ],
  "notice": "..."
}

单个国家

recommended与我们自己的报告遵循相同规则：采用该国官方数值，除非Ember的数据比其新一年以上。

GET https://carbonrecycling.co.uk/api/v1/electricity/countries/FRA?year=2025

{
  "data": {
    "iso3": "FRA",
    "name": "France",
    "reportingYear": 2025,
    "recommended": {
      "year": 2024,
      "kgCo2ePerKwh": 0.035,
      "source": "fr-ademe-base-carbone",
      "dataset": "Base Carbone V23.6, electricity average mix (combustion at the power station)",
      "basis": "..."
    },
    "ember": { "dataset": "Ember, Yearly Electricity Data", "generationTwh": 570.1, "mixPercent": { "Nuclear": 68.8, ... },
               "years": [ ..., { "year": 2025, "kgCo2ePerKwh": 0.04145 } ] },
    "official": { "publisher": "ADEME", "years": [ ..., { "year": 2024, "kgCo2ePerKwh": 0.035 } ], ... }
  },
  "attribution": [ { "source": "ember", ... }, { "source": "fr-ademe-base-carbone", ... } ],
  "notice": "..."
}

错误和限制

错误以{"error": {"status", "code", "message"}}格式返回。参数错误返回400，密钥缺失或已撤销返回401，账户未开通因子API时返回403（附订阅链接），因子、国家或端点未知时返回404，当月调用次数用完后返回429。

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1793491200
Retry-After: 1080000

{
  "error": {
    "status": 429,
    "code": "monthly_limit_reached",
    "message": "This account has used its 10,000 calls for this month. The count starts again on 2026-11-01, or move to a bigger tier.",
    "limit": 10000,
    "resetsAt": "2026-11-01T00:00:00.000Z",
    "upgrade": "https://carbonrecycling.co.uk/products/factor-api"
  }
}

许可和署名

我们只提供许可允许在付费产品中转授的数据，并保存每家发布方条款的注明日期的副本。每次返回结果都会列出其所依据的来源、许可以及需显示的署名。数据按发布原样提供，不作任何保证，且任何发布方均不为Carbon Recycling或您的产品背书。

• Department for Energy Security and Net Zero (DESNZ)：英国政府用于企业报告的温室气体换算因子。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含根据《开放政府许可》v3.0授权的公共部门信息。来源：DESNZ，《温室气体报告：换算因子》。
• Defra and the University of Leeds：基于支出的排放乘数（英国碳足迹）。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含根据《开放政府许可》v3.0授权的公共部门信息。来源：Defra，《英国碳足迹》。
• HM Revenue & Customs (HMRC) and HM Treasury：英国CBAM默认值和CBAM费率。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含根据《开放政府许可》v3.0授权的公共部门信息。来源：HMRC，《查看碳边境调节机制（CBAM）默认值》；HM Treasury和HMRC，《CBAM示例费率及计算示例》。
• Ember Energy Research CIC：Ember年度电力数据（按国家划分的电网强度）。 知识共享署名4.0国际许可（Creative Commons Attribution）. 署名：包含来自Ember的数据，根据CC BY 4.0授权（ember-energy.org）。
• US Environmental Protection Agency：EPA eGRID和GHG Emission Factors Hub（截至2025年版）。 US government work, public domain under 17 U.S.C. § 105. 署名：来源：US EPA，eGRID和GHG Emission Factors Hub。法律并未要求，但我们仍注明来源。
• 加拿大环境与气候变化部：加拿大《国家清单报告》附件7电力强度表。 Open Government Licence - Canada 2.0. 署名：包含根据《开放政府许可——加拿大》授权的信息（加拿大环境与气候变化部，《国家清单报告》）。
• Energy Market Authority, Singapore：新加坡能源市场管理局电网排放因子（data.gov.sg）。 Singapore Open Data Licence version 1.0. 署名：包含于2026年10月19日从data.gov.sg获取的Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor信息，依据新加坡开放数据许可第1.0版条款提供（https://data.gov.sg/open-data-licence）。
• ADEME (Agence de la transition écologique), France：ADEME Base Carbone（data.ademe.fr开放副本），电力。 Licence Ouverte / Open Licence 2.0 (Etalab). 署名：来源：ADEME，Base Carbone® V23.6（data.ademe.fr，最后更新于2025年7月3日），Licence Ouverte 2.0。
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia：《澳大利亚国家温室气体核算因子》（2022至2026年版）。 知识共享署名4.0国际许可（Creative Commons Attribution）. 署名：DCCEEW 2026，《澳大利亚国家温室气体核算因子》，气候变化、能源、环境和水资源部，堪培拉，8月。CC BY 4.0。（较早版本以相同方式署名，并注明各自年份。）
• Cornerstone Sustainability Data Initiative：Emission Factors Hub 2026（eGRID2024电力，AR6全球变暖潜势）。 知识共享署名4.0国际许可（Creative Commons Attribution）. 署名：Emission Factors Hub 2026，Cornerstone Sustainability Data Initiative，CC BY 4.0（doi:10.5281/zenodo.20403776）。
• Department for Energy Security and Net Zero (DESNZ)：燃料结构披露数据表（英国剩余能源结构）。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含根据《开放政府许可》v3.0授权的公共部门信息。来源：DESNZ，燃料结构披露数据表。
• Umweltbundesamt (UBA), Germany：Umweltbundesamt：1990年至2025年德国电力结构的特定温室气体排放（Climate Change 16/2026）。 Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. 署名：Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2)。数值已由Carbon Recycling从克换算为每kWh千克。
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China：生态环境部和国家统计局：2021年至2023年全国电力CO2排放因子。 Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. 署名：来源：中国生态环境部和国家统计局公告2024年第12号、2024年第33号和2025年第47号（全国平均电力CO2排放因子）。
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport)：环境部（新西兰）：《Measuring emissions》，2026年排放因子v2（长格式CSV），外购电力。 知识共享署名4.0国际许可（Creative Commons Attribution）. 署名：Ministry for the Environment。2026。Measuring emissions: A guide for organisations: 2026 emission factors（版本2）。皇家版权，根据CC BY 4.0授权。
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data：Postcodes.io（邮编到位置查询，仅限大不列颠邮编）。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含Ordnance Survey数据 © 皇家版权和数据库权利。包含Royal Mail数据 © Royal Mail版权和数据库权利。包含国家统计数据 © 皇家版权和数据库权利。包含NRS数据 © 皇家版权和数据库权利。邮编查询由postcodes.io提供。
• Environment Agency：Environment Agency实时洪水监测API（洪水预警和警报区域、当前预警）。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：本服务使用Environment Agency实时数据API（Beta）中的洪水和河流水位数据。
• Environment Agency：Environment Agency河流与海洋洪水风险及地表水洪水风险（NaFRA2），当前和气候变化情景，通过Defra WMS获取。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：© Environment Agency版权和/或数据库权利2025。保留所有权利。包含根据《开放政府许可》v3.0授权的公共部门信息。
• Scottish Environment Protection Agency (SEPA)：SEPA洪水地图（河流、沿海、地表水和小型水道；当前和未来），开放地图服务。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：©SEPA 2025；此SEPA产品根据《开放政府许可》第3.0版授权。
• Natural Resources Wales：Natural Resources Wales威尔士洪水风险评估（河流、海洋、地表水和小型水道）及洪水预警区域，通过DataMapWales获取。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含Natural Resources Wales信息 © Natural Resources Body for Wales及数据库权利。保留所有权利。洪水流量估算基于FEH方法和数据，© 及数据库权利UKCEH 2015。包含Ordnance Survey数据，皇家版权和数据库权利。根据《开放政府许可》v3.0授权。
• Met Office：Met Office气候数据门户：全球变暖水平下的UKCP18地方政府区域预测（夏季高温日数、热带夜、夏季最高气温、夏季和冬季降雨量）。 开放政府许可证 v3.0（Open Government Licence v3.0）. 署名：包含根据《开放政府许可》v3.0授权的Met Office数据。包含OS和ONS数据 © 皇家版权和数据库权利。来源：Met Office气候数据门户，UKCP18地方政府区域预测。

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xero会计API（客户自己的账簿）
• EXIOBASE 3多区域投入产出（适用于所有国家的支出因子）
• IEA排放因子
• ecoinvent
• SEAI换算因子和排放因子（爱尔兰），GHG_elec工作表（2001年至2025年电力）
• DESNZ在2021年及更早因子集中的海外电力排放因子，这些因子依据IEA数据并受IEA自有许可约束

其条款禁止转售或再分发数据，因此这些数据不纳入API。完整登记信息请参阅我们的数据来源页面。