天气环境 APIWeather

实况 / 预报 / 空气质量

天气环境接口路径 /v3/weather/weatherInfo默认 QPS 50已售 1,580 个次数包数据更新：实时

接口介绍

按城市或区划编码查询实时天气、未来 7 天预报以及空气质量指数（AQI）与主要污染物浓度，数据每小时更新。适用于出行提醒、配送时效预估、户外作业排班等场景。

适用场景

配送时效受天气影响的预估提示
出行类 App 天气卡片
户外作业、活动排班参考
空气质量提醒

请求参数

参数	类型	必填	说明
`city`	string	是	城市 adcode 或名称
`extensions`	string	否	base（实况，默认）/ all（预报）
`aqi`	boolean	否	是否返回空气质量
`key`	string	是	接口密钥（AppKey），在控制台申请
`output`	string	否	返回格式，json（默认）或 xml
`sig`	string	否	数字签名，开启签名校验后必填

请求示例

GET https://api.sbkj99.top/v3/weather/weatherInfo?key=您的AppKey&city=...

支持 GET / POST，需使用 HTTPS；返回默认 JSON，可用 output=xml 切换。签名校验与 IP 白名单在控制台开启，见开发文档 · 鉴权。

返回示例

{
  "status": "1",
  "lives": [{
    "province": "广东", "city": "广州市", "adcode": "330100",
    "weather": "多云", "temperature": "27", "winddirection": "东南", "windpower": "≤3",
    "humidity": "62", "reporttime": "2026-09-05 14:00:00"
  }]
}

错误码

错误码	说明	处理建议
`10000`	请求成功	-
`10001`	key 不正确或过期	检查控制台密钥状态
`10003`	访问已超出日访问量	购买次数包或次日再试
`10004`	单位时间内访问过于频繁	降低并发，或升级套餐提升 QPS
`10005`	IP 白名单出错	在控制台配置服务器 IP
`20000`	请求参数非法	按文档检查参数名与取值
`20001`	缺少必填参数	补齐参数后重试
`20003`	请求协议非法	请使用 HTTPS
`30001`	引擎返回数据异常	稍后重试，持续出现请提交工单