/ 接口详情
接口信息
GET / POST
xiaoapi.cn/v1/zs_tq.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type | string | 是 | 天气来源，仅可为：moji、baidu、zgtq、zytq、cytq，分别为：墨迹天气、百度天气、中国天气、中央天气、彩云天气。 | cytq |
| msg | string | 是 | 城市名称或地区名称，支持县级. | 宁波 |
| num | integer | 否 | 返回列表数量，默认为5条 | 5 |
| n | integer | 否 | 有则返回当前搜索列表指定的第n条地区天气，无则返回列表 | 1 |
[
{
"name": "type",
"type": "string",
"required": true,
"description": "天气来源，仅可为：moji、baidu、zgtq、zytq、cytq，分别为：墨迹天气、百度天气、中国天气、中央天气、彩云天气。",
"example": "cytq"
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "城市名称或地区名称，支持县级.",
"example": "宁波"
},
{
"name": "num",
"type": "integer",
"required": false,
"description": "返回列表数量，默认为5条",
"example": "5"
},
{
"name": "n",
"type": "integer",
"required": false,
"description": "有则返回当前搜索列表指定的第n条地区天气，无则返回列表",
"example": "1"
}
]
{"openapi":"3.1.1","info":{"title":"天气","description":"天气查询，内含百度天气、墨迹天气、中国天气、中央天气、彩云天气。","version":"1.0.0"},"paths":{"/v1/zs_tq.php":{"get":{"summary":"天气","description":"天气查询，内含百度天气、墨迹天气、中国天气、中央天气、彩云天气。","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","example":"cytq"},"description":"天气来源，仅可为：moji、baidu、zgtq、zytq、cytq，分别为：墨迹天气、百度天气、中国天气、中央天气、彩云天气。"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"宁波"},"description":"城市名称或地区名称，支持县级."},{"name":"num","in":"query","required":false,"schema":{"type":"integer","example":5},"description":"返回列表数量，默认为5条"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"有则返回当前搜索列表指定的第n条地区天气，无则返回列表"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"天气","description":"天气查询，内含百度天气、墨迹天气、中国天气、中央天气、彩云天气。","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","example":"cytq"},"description":"天气来源，仅可为：moji、baidu、zgtq、zytq、cytq，分别为：墨迹天气、百度天气、中国天气、中央天气、彩云天气。"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"宁波"},"description":"城市名称或地区名称，支持县级."},{"name":"num","in":"query","required":false,"schema":{"type":"integer","example":5},"description":"返回列表数量，默认为5条"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"有则返回当前搜索列表指定的第n条地区天气，无则返回列表"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口（http）"}]}
返回示例
{
"code": 200,
"keyWord": "毕节",
"name": "中国 贵州省 毕节市 毕节",
"data": "温度：16.44℃\\n体感：16.9℃\\n湿度：90%\\n能见度：0.05千米\\npm2.5：3\\n空气质量：12\\n紫外线强度：无\\n总体感觉：凉爽\\n您东北7公里正在下小雨哦，阴，今天晚间23点钟后转大雨，其后小雨\n预警信息：【预警中】七星关区气象台2026年09月16日20时57分继续发布雷电黄色预警信号：预计未来6小时我区层台、洪山、碧阳、阿市、大屯、放珠、水箐、海子街、市西、燕子口、市东、野角、长春堡、普宜、杨家湾、田坝桥、小吉场、撒拉溪、八寨、亮岩、碧海、青场、田坎、何官屯、大河、德溪、龙场营、三板桥、鸭池、响水、梨树、青龙、小坝、清水铺等乡镇（街道）受雷雨天气影响，雷雨中将出现短时强降水、大风等强对流天气，请注意防范雷电灾害事故，相关镇街和部门做好雷电应对工作。（数据来源：国家预警信息发布中心）\n",
"tips": "慕名API：http://xiaoapi.cn"
}
详细文档
天气
接口说明
天气接口用于按城市或地区名称查询实时天气信息，支持县级地区。
可指定墨迹天气、百度天气、中国天气、中央天气、彩云天气等来源，适合天气类应用、出行提示等场景调用。
调用地址
https://xiaoapi.cn/v1/zs_tq.php请求方式
支持 GET 与 POST 两种方式，二者参数一致，均以查询字符串或表单形式提交。
鉴权说明
本接口无需密钥，可直接调用，不产生费用。
请求参数
调用地址：https://xiaoapi.cn/v1/zs_tq.php，请求方式：GET 或 POST。本接口无需密钥，免费调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 天气来源，仅可取 moji、baidu、zgtq、zytq、cytq 之一 |
| msg | string | 是 | 城市名称或地区名称，支持县级地区 |
| num | integer | 否 | 返回列表数量，默认 5 条 |
| n | integer | 否 | 传入时返回搜索列表中指定的第 n 条地区天气；不传则返回列表 |
参数取值说明：
type取值对应关系：moji为墨迹天气，baidu为百度天气，zgtq为中国天气，zytq为中央天气，cytq为彩云天气。msg建议填写规范地名，如「宁波」；同名地区较多时可先不传n查看列表，再配合n定位具体地区。num仅在未传n、需要返回列表时生效；传入非正整数值时以服务端处理结果为准。n从 1 开始计数，对应列表中第 n 条记录；当n超出实际列表范围时，可能无法返回对应天气内容。
成功响应示例
{
"code": 200,
"keyWord": "毕节",
"name": "中国 贵州省 毕节市 毕节",
"data": "温度：16.44℃\\n体感：16.9℃\\n湿度：90%\\n能见度：0.05千米\\npm2.5：3\\n空气质量：12\\n紫外线强度：无\\n总体感觉：凉爽\\n您东北7公里正在下小雨哦，阴，今天晚间23点钟后转大雨，其后小雨\n预警信息：【预警中】七星关区气象台2026年09月16日20时57分继续发布雷电黄色预警信号：预计未来6小时我区层台、洪山、碧阳、阿市、大屯、放珠、水箐、海子街、市西、燕子口、市东、野角、长春堡、普宜、杨家湾、田坝桥、小吉场、撒拉溪、八寨、亮岩、碧海、青场、田坎、何官屯、大河、德溪、龙场营、三板桥、鸭池、响水、梨树、青龙、小坝、清水铺等乡镇（街道）受雷雨天气影响，雷雨中将出现短时强降水、大风等强对流天气，请注意防范雷电灾害事故，相关镇街和部门做好雷电应对工作。（数据来源：国家预警信息发布中心）\n",
"tips": "慕名API：http://xiaoapi.cn"
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 请求结果状态，200 表示查询成功 |
| keyWord | string | 本次查询使用的城市或地区关键词 |
| name | string | 匹配到的地区完整名称，通常包含国家、省份、城市与具体地区 |
| data | string | 天气详情文本，包含温度、体感、湿度、能见度、pm2.5、空气质量、紫外线强度、总体感觉，以及临近降水、天气变化与预警信息等，各条目以换行分隔；使用 n 参数时对应指定序号的地区 |
| tips | string | 接口提示信息 |
说明：data 为纯文本内容，字段构成随所选天气来源与地区实际数据情况有所差异，未提供的数据项可能不出现。
错误响应示例
调用未成功时，返回体为统一 JSON 结构：不包含业务数据字段，code 恒为 0，msg 为可读的错误描述，errcode 为业务错误码。
{"code":0,"msg":"未提供调用密钥","errcode":11001}{"code":0,"msg":"积分余额不足","errcode":11004}{"code":0,"msg":"请求过于频繁（QPM 限制）","errcode":11005}{"code":0,"msg":"接口不存在","errcode":11013}
## 调用示例
### 终端 curl（bash）
```bash
curl --get "https://xiaoapi.cn/v1/zs_tq.php" \
--data-urlencode "type=cytq" \
--data-urlencode "msg=宁波" \
--data-urlencode "num=5"指定返回列表中的第 1 条地区天气：
curl --get "https://xiaoapi.cn/v1/zs_tq.php" \
--data-urlencode "type=moji" \
--data-urlencode "msg=毕节" \
--data-urlencode "n=1"PHP
// PHP 示例
$params = [
'type' => 'cytq',
'msg' => '宁波',
'num' => 5,
];
$url = 'https://xiaoapi.cn/v1/zs_tq.php?' . http_build_query($params);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
curl_close($ch);
echo $response;注意事项
- 接口地址固定为
https://xiaoapi.cn/v1/zs_tq.php，请始终通过 HTTPS 调用，不要使用明文 HTTP，以免请求参数与返回内容在传输过程中被篡改。 - 本接口无需密钥，可匿名直接调用，因此更需注意不要将调用地址嵌入公开的前端页面并被他人批量抓取；如需在网页中展示天气，建议由自己的服务端转发后再渲染。
- 免费接口请合理控制调用频率，避免秒级轮询、并发压测或批量遍历全国城市；高频异常请求可能被限流甚至暂时拒绝服务。
- 请求方式
快速上手
curl -G "http://xiaoapi.cn/v1/zs_tq.php" \
--data-urlencode "type=cytq" \
--data-urlencode "msg=宁波" \
--data-urlencode "num=5" \
--data-urlencode "n=1"
# 免费接口，无需密钥；type 可选 moji/baidu/zgtq/zytq/cytq在线测试
请求地址
xiaoapi.cn/v1/zs_tq.php
Method
参数
Response
// 结果将在此处显示
接口反馈
推荐接口
