北京 PM2.5 空气质量包（Beijing PM2.5）

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

1. 1
   获取凭证

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

2. 2
   发起请求

   GET /api/v1/data/government-beijing-pm25/rows?page=1&size=10，Header：X-API-Key

3. 3
   解析响应

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

4. 4
   处理错误

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

完整 API 文档 →

{
  "fields": [
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "No",
      "nullable": false,
      "nunique": 43824
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "year",
      "nullable": false,
      "nunique": 5
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "month",
      "nullable": false,
      "nunique": 12
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "day",
      "nullable": false,
      "nunique": 31
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "hour",
      "nullable": false,
      "nunique": 24
    },
    {
      "dtype": "float64",
      "is_label": true,
      "kind": "numeric",
      "name": "pm25",
      "nullable": true,
      "nunique": 581
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "DEWP",
      "nullable": false,
      "nunique": 69
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "TEMP",
      "nullable": false,
      "nunique": 64
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "PRES",
      "nullable": false,
      "nunique": 60
    },
    {
      "dtype": "str",
      "is_label": false,
      "kind": "numeric",
      "name": "cbwd",
      "nullable": false,
      "nunique": 4
    },
    {
      "dtype": "float64",
      "is_label": false,
      "kind": "numeric",
      "name": "Iws",
      "nullable": false,
      "nunique": 2788
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Is",
      "nullable": false,
      "nunique": 28
    },
    {
      "dtype": "int64",
      "is_label": false,
      "kind": "numeric",
      "name": "Ir",
      "nullable": false,
      "nunique": 37
    }
  ],
  "format": "csv",
  "label_column": "pm25",
  "license_hint": "CC BY 4.0",
  "source_name": "Beijing PM2.5 Data (UCI)",
  "source_url": "https://archive.ics.uci.edu/dataset/381/beijing+pm2+5+data"
}

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

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

import requests

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