天

天气预报

支持 HTTPS

分类：天气环境接口标识：weather

查询城市天气：温度、湿度、AQI、天气、风向等（端点待与聚合文档核对）

每日免费 50 次免费额度每日 0 点自动重置

注册领取 Key 查看 API 文档

功能介绍 / Introduction

支持 HTTPS，GET / POST 均可调用
每用户每日免费 50 次，按天自动重置
统一 JSON 响应结构 {code, msg, data}
网关代理转发，无需关心上游接口差异
本站 Key 一键吊销，配额与调用记录可查

查询城市天气：温度、湿度、AQI、天气、风向等（端点待与聚合文档核对）。通过本站统一网关调用，使用本站签发的 Key 即可访问，无需分别对接上游服务。

应用场景 / Scenes

快速集成：一个 Key 访问全部已上架接口，注册即用，分钟级完成接入。
配额透明：每日调用次数实时可查，Key 可随时吊销，适合开发测试与小规模业务。
在线调试：文档页与用户中心均提供在线测试，填入参数即可看到真实 JSON 返回。

接口地址 / Endpoint

/v1/weather?key=你的key&city=上海

请求方式	GET / POST
返回格式	JSON（UTF-8）
鉴权方式	查询参数 `key` 或请求头 `X-API-Key`
每日额度	50 次 / Key

请求参数 / Parameters

参数	必填	类型	说明	默认值
`key`	是	string	调用凭证，在「我的 Key」页面创建获得	—
`city`	是	string	城市名称，如上海	—

返回参数 / Response

统一响应结构 {code, msg, data}：code=0 表示成功，业务数据在 data 字段中；非 0 时 msg 为错误说明。

天气预报

查询城市天气：温度、湿度、AQI、天气、风向等（端点待与聚合文档核对）

请求示例

GET /v1/weather?key=你的key&city=示例值

请求参数

参数	必填	类型	说明
city	是	string	城市名称，如上海

返回说明

统一响应结构 {code, msg, data}，code=0 表示成功，业务数据在 data 中：

{"code":0,"msg":"success","data":{"city":"上海","realtime":{"temperature":"25","info":"晴"},"future":[...]}}

本站业务错误码 / Gateway Errors

code	HTTP 状态	说明
`0`	200	请求成功
`40001`	401	缺少 key 参数
`40002`	401	无效的 key（不存在或已吊销）
`40004`	429	今日免费额度已用完
`40005`	400	缺少必填参数
`41001`	429	请求过于频繁（触发 IP 限流）
`41002`	404	接口不存在或已下架
`41003 / 41004`	503	接口维护中 / 已停用
`50001 / 50002`	502	上游网络异常 / 响应解析失败
`50003 / 50004`	502	上游配额耗尽 / 上游 Key 配置错误
`50010`	502	上游业务错误（响应附带 `juhe_error_code`）

上游系统级错误码 / Upstream Errors

juhe_error_code	说明
`10001`	错误的请求 KEY
`10002`	该 KEY 无请求权限
`10003`	KEY 已过期
`10012`	请求超过次数限制
`10020`	接口维护中
`10021`	接口已停用

cURL 示例 / cURL

curl "https://www.fendinfo.com/v1/weather?key=你的key&city=上海"

Python 示例 / Python

import requests

url = "https://www.fendinfo.com/v1/weather"
params = {
    "key": "你的key",
    "city": "上海",
}

resp = requests.get(url, params=params)
print(resp.json())  # {"code": 0, "msg": "success", "data": {...}}