一、接口简介
接口盒子该接口可查询 全国 2000+ 城市/地区 的天气温度排行，支持按「白天温度」或「夜间温度」排序，同时附带当日天气预报 + 当前实时天气要素（温度、降水、气压、湿度、风力风向、体感温度等）。
典型用途：
- 🔥 做「今日全国最热/最冷城市榜」
- 📰 资讯类站点自动拉取温度排行
- 📱 小程序 / App 天气模块的数据源之一
二、请求信息
项目 |
值 |
请求地址 |
|
请求方式 |
GET 或 POST 均可 |
数据格式 |
返回 JSON |
三、请求参数
参数 |
必填 |
说明 |
|
✅ |
用户中心的数字 ID，如 |
|
✅ |
用户中心通讯秘钥 |
|
❌ |
排行类型： |
|
❌ |
排序方式： |
|
❌ |
页码，每页 10 条，默认第 1 页 |
四、返回参数（核心字段）
顶层
字段 |
说明 |
|
|
|
提示信息 |
|
当前页码 |
|
最大页数 |
|
排名数据集（数组） |
data 每条记录
字段 |
说明 |
|
排名 |
|
省 |
|
市 |
|
地区名 |
|
白天温度(℃) |
|
夜间温度(℃) |
|
白天/夜间天气文字 |
|
天气图标 URL |
|
风向 |
|
风力等级 |
|
当前实时天气对象 |
nowdata 子字段
precipitation（降水）、temperature（当前温）、pressure（气压）、humidity（湿度）、windDirection、windSpeed、windScale、feelst（体感）、uptime（更新时间，缺数据会显示 9999）。
五、GET 请求示例（原文档）
GET https://cn.apihz.cn/api/tianqi/tqybwdpx.php?id=88888888&key=88888888&type=1&px=1&page=1
返回（节选）：
{ "code": 200, "page": 1, "maxpage": 244, "data": [ { "top": 1, "sheng": "新疆", "shi": "托克逊", "name": "托克逊", "wd1": "38", "wd2": "20", "weather1": "多云", "nowdata": { "temperature": 33.2, "feelst": 31.8, "humidity": 7, "uptime": "2026/05/04 12:40" } } ] }
六、PHP 调用示例（cURL POST）
<?php /** * 全国天气温度排行 API - PHP cURL 示例 */ $api = 'https://cn.apihz.cn/api/tianqi/tqybwdpx.php'; $params = [ 'id' => '你的ID', 'key' => '你的KEY', 'type' => 1, // 1=白天温度 'px' => 1, // 1=高到低 'page' => 1, ]; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $api, CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query($params), CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, ]); $response = curl_exec($ch); if (curl_errno($ch)) { echo 'cURL 错误：' . curl_error($ch); exit; } curl_close($ch); $data = json_decode($response, true); if ($data['code'] != 200) { echo '接口返回错误：' . $data['msg']; exit; } // 打印前 10 条 foreach ($data['data'] as $row) { printf( "TOP%d %s-%s-%s：白天%s℃ / 夜间%s℃，当前实况%s℃（%s）\n", $row['top'], $row['sheng'], $row['shi'], $row['name'], $row['wd1'], $row['wd2'], $row['nowdata']['temperature'], $row['weather1'] ); }
七、Python 调用示例（requests）
""" 全国天气温度排行 API - Python requests 示例 pip install requests """ import requests API = "https://cn.apihz.cn/api/tianqi/tqybwdpx.php" params = { "id": "你的ID", "key": "你的KEY", "type": 1, # 1=白天 "px": 1, # 1=高到低 "page": 1, } resp = requests.get(API, params=params, timeout=10) resp.raise_for_status() data = resp.json() if data["code"] != 200: raise RuntimeError(f"接口错误：{data['msg']}") print(f"第 {data['page']} 页 / 共 {data['maxpage']} 页\n") for row in data["data"]: now = row["nowdata"] print( f"TOP{row['top']:>3} " f"{row['sheng']}-{row['shi']}-{row['name']} | " f"白天{row['wd1']}℃ / 夜间{row['wd2']}℃ | " f"当前{now['temperature']}℃ 体感{now['feelst']}℃ " f"{row['weather1']}" )
运行效果类似：
TOP 1 新疆-托克逊-托克逊 | 白天38℃ / 夜间20℃ | 当前33.2℃ 体感31.8℃ 多云 TOP 2 新疆-吐鲁番-吐鲁番 | 白天37℃ / 夜间21℃ | 当前31.4℃ 体感29.9℃ 多云 ...
