建筑能耗效率包（Energy Efficiency）

通过统一 API 拉取数据（全站接口相同，仅替换 slug）。

1. 1
   获取凭证

   登录 → 购买 → 在 申请 API Key 签发密钥（仅显示一次）

2. 2
   发起请求

   GET /api/v1/data/energy-building-load/rows?page=1&size=10，Header：X-API-Key

3. 3
   解析响应

   从 JSON 的 rows 取数据，用 total 翻页

4. 4
   处理错误

   401 密钥无效 · 403 未购买/无权 · 400 参数错误 · 429 过频 · 502 上游失败

完整 API 文档 →

{
  "fields": [
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "relative_compactness",
      "nullable": false,
      "nunique": 12
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "surface_area",
      "nullable": false,
      "nunique": 12
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "wall_area",
      "nullable": false,
      "nunique": 7
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "roof_area",
      "nullable": false,
      "nunique": 4
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "overall_height",
      "nullable": false,
      "nunique": 2
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "orientation",
      "nullable": false,
      "nunique": 4
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "glazing_area",
      "nullable": false,
      "nunique": 4
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "glazing_area_distribution",
      "nullable": false,
      "nunique": 6
    },
    {
      "dtype": "float64",
      "is_label": true,
      "kind": "numeric",
      "name": "heating_load",
      "nullable": false,
      "nunique": 587
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "cooling_load",
      "nullable": false,
      "nunique": 636
    }
  ],
  "format": "csv",
  "label_column": "heating_load",
  "license_hint": "CC BY 4.0",
  "source_name": "Energy Efficiency (UCI)",
  "source_url": "https://archive.ics.uci.edu/dataset/242/energy+efficiency"
}

路径中的 slug 换成已购商品标识即可。完整说明见 API 文档。

curl -H "X-API-Key: ds_你的密钥" \
  "https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows?page=1&size=10"

import requests

r = requests.get(
    "https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows",
    headers={"X-API-Key": "ds_你的密钥"},

    params={"page": 1, "size": 10},

    timeout=30,
)
r.raise_for_status()
print(r.json())

const apiKey = "ds_你的密钥";
const url = new URL("https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows");

url.searchParams.set("page", "1");
url.searchParams.set("size", "10");


const resp = await fetch(url, {
  headers: { "X-API-Key": apiKey },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const payload = await resp.json();
console.log(payload);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows?page=1&size=10"))
    .header("X-API-Key", "ds_你的密钥")
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET",
		"https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows?page=1&size=10", nil)
	req.Header.Set("X-API-Key", "ds_你的密钥")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(body))
}

using System.Net.Http;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "ds_你的密钥");
var json = await client.GetStringAsync("https://www.dataocean.zhixxing.cn/api/v1/data/energy-building-load/rows?page=1&size=10");
Console.WriteLine(json);