能源负荷/功率包（UCI Household Power）

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

1. 1
   获取凭证

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

2. 2
   发起请求

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

3. 3
   解析响应

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

4. 4
   处理错误

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

完整 API 文档 →

{
  "fields": [
    {
      "dtype": "datetime64[us]",
      "is_label": false,
      "is_time": true,
      "kind": "datetime",
      "name": "timestamp",
      "nullable": false,
      "nunique": 2075259
    },
    {
      "dtype": "float64",
      "is_label": true,
      "is_time": false,
      "kind": "numeric",
      "name": "Global_active_power",
      "nullable": true,
      "nunique": 4186
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Global_reactive_power",
      "nullable": true,
      "nunique": 532
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Voltage",
      "nullable": true,
      "nunique": 2837
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Global_intensity",
      "nullable": true,
      "nunique": 221
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Sub_metering_1",
      "nullable": true,
      "nunique": 88
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Sub_metering_2",
      "nullable": true,
      "nunique": 81
    },
    {
      "dtype": "float64",
      "is_label": false,
      "is_time": false,
      "kind": "numeric",
      "name": "Sub_metering_3",
      "nullable": true,
      "nunique": 32
    }
  ],
  "format": "timeseries",
  "freq_guess": "min",
  "label_column": "Global_active_power",
  "layout": "single_csv",
  "license_hint": "CC BY 4.0",
  "source_file": "train.csv",
  "source_name": "Individual household electric power consumption (UCI)",
  "source_url": "https://archive.ics.uci.edu/dataset/235/individual+household+electric+power+consumption",
  "time_column": "timestamp"
}

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

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

import requests

r = requests.get(
    "https://www.dataocean.zhixxing.cn/api/v1/data/energy-uci-power/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-uci-power/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-uci-power/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-uci-power/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-uci-power/rows?page=1&size=10");
Console.WriteLine(json);