开发者接口
把本站的碳计算内核，外发成你的软件可以直接调用的接口。网页上算出来的结果，接口就是同一份 —— 同一个内核、同一组函数、同一套政策口径，不存在"两套算法"。
当前已开放 8 条路由（6 个能力域）：因子查询、碳资产测算、产品碳足迹、碳配额盈亏、CCER 方法学、调用用量。
服务状态（实时读取，不是写死的）
正在读取服务状态…
上面那张端点清单来自服务端的现场响应 —— 如果它与下方「接口参考」不一致，页面会直接提示，不留到线上才被发现。
三步接入
联系商务开通 API Key，同时确定三件事：能调用哪些能力、披露级别（L1 / L2 / L3）、频率配额。本站不提供自助申请。
调 GET /api/v1/health 确认连通（公开端点，不需要 Key）。拿到 ok: true 说明链路没问题。
按下方「接口参考」接入需要的端点。所有响应共用同一个信封：ok / contract / disclosure / result / meta，一段代码解析全部。
接口参考（点开逐条看入参、分级与示例）
在线试用台
真发请求、看真响应。凭据只保存在你自己浏览器的本地存储里，本页不上传、不记录、不写进任何日志。 生产环境请把 Key 放在你自己的服务端调用 —— 写进前端代码等于公开。
https://www.cn3060.cn 才能联通。只能在 Key 自身级别以内降级取数，越级一律 403。
分级披露（L1 / L2 / L3）
计算结果里的「实现参数面」（基准值、调峰系数、强度系数、分配比例、物料因子、电网因子等）属于核心资产， 按级别放行：客户可以降级取数，不能越级。
| 级别 | 给什么 | 适用对象 | 审批 |
|---|---|---|---|
| L1 黑盒（默认） | 只有结果。碳资产类连吨数都不给，只给钱 | 绝大多数客户 | 自动 |
| L2 半白 | 加：分项明细、数据质量、口径说明、缺口与补测建议 | 核查机构 / 设计院 / 需要第三方核验的场合 | 商务确认 |
| L3 全白 | 加：逐行实现参数与公式、参数表 | 战略合作方 / 政府项目 | 逐案审批 |
为什么 L1 连碳汇吨数都不给？客户知道自己的林地面积 —— 一旦同时拿到吨数，用「吨数 ÷ 自己的面积」就把亩系数反推出来了。所以严格黑盒只给打包后的收益，不给吨数、不给面积分项。
L2 的真实边界：面积与收益同时给出时，系数在数学上仍可被反推 —— 这是披露的物理边界，不是设计缺陷。要真黑盒，就用 L1。
L3 一旦给出不可收回 —— 当它是单行道，不是"以后再说"。
响应信封与错误码
所有端点共用同一个信封 —— 成功与失败都能用同一段代码解析。meta.requestId 可用来对账。
{
"ok": true, // 成功为 true；失败为 false
"contract": "v1", // 契约版本，将来 v2 并存不改路径
"disclosure": "L1", // 本次实际生效的披露级别
"result": { … }, // 端点自己的结果体
"meta": {
"kernelVersion": "…", // 计算内核版本 —— 换内核时你能看出来
"requestId": "req_…", // 请求编号，排查时提供它即可定位
"ts": "2026-09-24T13:20:00+08:00"
}
}
{
"ok": false,
"contract": "v1",
"error": {
"code": "VALIDATION_FAILED",
"message": "请提供面积：totalMu（申报总面积，亩）或 ccerArea（CCER 适用面积，亩）。",
"details": { "field": "totalMu" } // 字段级定位，可选
},
"meta": { "ts": "…", "requestId": "req_…" }
}
错误响应不返回堆栈或内部路径，只给错误码、可读说明与可选的字段级定位。
常见问题
接口结果依据公开发布的政策文件与国家/行业标准口径测算，供决策参考，不构成第三方核查结论。 涉及履约与交易的最终数字，请以具备资质的核查机构出具的结论为准。