天气查询

上新

天气查询:和风天气实时天气与多日预报(按城市名)

天气查询(和风天气):

参数:
- action:now 实时(默认)/ daily 预报 / lookup 城市搜索
- city / location:城市名(如昆明)、LocationID,或「经度,纬度」
- days:预报天数,仅 daily 时有效,支持 3 或 7,默认 3

说明:上游为和风天气开发服务,按次计为网关转发调用。

调用地址:https://api.ynlskj.com.cn/gateway/weather

请求方法:POST

在其他地方怎么调用

  1. 请求地址用上面的调用地址,把 JSON 放在请求体里
  2. 方法用 POST
  3. API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
  4. Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key

参数说明

参数位置必填说明
actionBody JSONnow 实时(默认)/ daily 预报 / lookup 城市搜索
cityBody JSON城市名,如昆明。也可用 location。支持 LocationID 或 经度,纬度
daysBody JSONdaily 时否预报天数:3 或 7,默认 3
X-API-KeyHeader你的 API Key

请求示例

场景Body 示例
实时天气{"action":"now","city":"昆明"}
3 日预报{"action":"daily","city":"北京","days":3}
城市搜索{"action":"lookup","city":"五华"}

数据来源:和风天气。城市名会先走 Geo 查询再取天气。

返回说明

字段说明
retok 成功,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":"和风天气"}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录