天气查询
上新天气查询:和风天气实时天气与多日预报(按城市名)
天气查询(和风天气):
参数:
- action:now 实时(默认)/ daily 预报 / lookup 城市搜索
- city / location:城市名(如昆明)、LocationID,或「经度,纬度」
- days:预报天数,仅 daily 时有效,支持 3 或 7,默认 3
说明:上游为和风天气开发服务,按次计为网关转发调用。
参数:
- action:now 实时(默认)/ daily 预报 / lookup 城市搜索
- city / location:城市名(如昆明)、LocationID,或「经度,纬度」
- days:预报天数,仅 daily 时有效,支持 3 或 7,默认 3
说明:上游为和风天气开发服务,按次计为网关转发调用。
调用地址:https://api.ynlskj.com.cn/gateway/weather
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
action | Body JSON | 否 | now 实时(默认)/ daily 预报 / lookup 城市搜索 |
city | Body JSON | 是 | 城市名,如昆明。也可用 location。支持 LocationID 或 经度,纬度 |
days | Body JSON | daily 时否 | 预报天数:3 或 7,默认 3 |
X-API-Key | Header | 是 | 你的 API Key |
请求示例
| 场景 | Body 示例 |
|---|---|
| 实时天气 | {"action":"now","city":"昆明"} |
| 3 日预报 | {"action":"daily","city":"北京","days":3} |
| 城市搜索 | {"action":"lookup","city":"五华"} |
数据来源:和风天气。城市名会先走 Geo 查询再取天气。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.action | 实际动作:now / daily / lookup |
data.place | 解析到的城市信息(名称、省市区、经纬度等) |
data.now | 实时天气:气温、体感、天气现象、风力、湿度等 |
data.daily | 预报数组(action=daily) |
data.list | 城市搜索结果(action=lookup) |
data.source | 数据来源:和风天气 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/weather');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"action": "now",
"city": "昆明"
}',
]);
echo curl_exec($ch);
请求参数演示
{"action":"now","city":"昆明"}
响应演示
{"ret":"ok","data":{"action":"now","place":{"name":"昆明","id":"101290101","adm1":"云南省","adm2":"昆明","country":"中国","lat":"25.04","lon":"102.71"},"location":"101290101","update_time":"2026-09-16T12:00+08:00","now":{"obs_time":"2026-09-16T11:50+08:00","temp":"24","feels_like":"24","text":"晴","icon":"100","wind_dir":"西南风","wind_scale":"1","wind_speed":"4","humidity":"55","precip":"0.0","pressure":"1012","vis":"20","cloud":"10","dew":"14"},"source":"和风天气"}}