云岭API开放平台
首页 / API 文档 / 天气查询

天气查询

查询城市实时天气与未来预报,数据来自公开天气服务,支持智慧城市/区县名。

¥0.002/次 需 API Key5 QPS最后更新 2026-11-23
接口信息

天气查询 v1.0

查询城市实时天气与未来预报,数据来自公开天气服务,支持智慧城市/区县名。

接口地址https://api.ynshw.com.cn/api.php?action=Weather&city=%E6%98%86%E6%98%8E
请求方式GET,POST
返回格式JSON
QPS 限制5
计费2 积分/次
鉴权说明在请求中携带 key 参数(或请求头 X-API-Key / Authorization: Bearer)。生产环境建议启用签名:将参数按名排序拼接为 secret&ts&nonce&k=v&... 后取 MD5,随 sign/ts/nonce 一起传入。

请求示例

https://api.ynshw.com.cn/api.php?action=Weather&city=%E6%98%86%E6%98%8E
请求参数

请求参数

参数名类型必填说明
citystring是城市名,如 昆明、北京
keystring是API Key,控制台获取
sign/ts/noncestring否签名三元组,启用后防重放(5 分钟有效)
返回参数

返回参数

参数名类型说明
codeint状态码,200 为成功
msgstring提示信息
citystring城市
weatherstring天气状况
tempstring温度
forecastarray预报列表

返回示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "city": "昆明",
        "weather": "多云",
        "temp": "18℃",
        "forecast": []
    }
}
在线测试

在线测试

需要 API Key请先 登录 并在控制台复制你的 Key,填入下方即可真实发起调用。
// 点击「发送请求」查看返回结果
示例代码

多语言示例

错误码

响应状态码

code说明
200成功
201参数错误
202鉴权失败(Key 无效/签名错误/已过期)
203次数或余额不足
204接口不存在
205接口停用
206请求方式不允许
207请求限流(超出 QPS)
208IP 不在白名单
209内部错误
210需实名认证