全国天气预报正常
获取全国今天天气及最近7天的天气预报情况
调用次数
11 次
请求频率限制
5 次/秒
计费单价
4点/次（≈0.004元/次）
API文档
今日天气
一周天气
接口调试
接口地址
https://api.29783.com/weather/today 复制
计费单价
4点/次（≈0.004元/次）
文件下载
https://cache.29783.com/weather/weather.zip（天气图标文件）
文件下载
https://cache.29783.com/common/region-code.json（行政区划分代码文件）
返回格式
JSON
请求方式
HTTPSGETPOST
Header参数
名称 类型 必须 示例值 说明
id String 是 您自己的Api ID（注册登录后在秘钥管理中获得） 是
key String 是 您自己的Api Key（注册登录后在秘钥管理中获得） 是
请求参数
名称 类型 必须 示例值 说明
code Number 可选 330200 行政区划代码
ip String 可选 123.152.251.58 默认为请求iP,仅当用户没有提供行政区划代码时有效
返回参数
名称 类型 示例值 说明
返回结果公共参数
code Number 0 接口返回状态码，0为成功
message String 成功 接口返回文本信息
data Object/Array 返回结果数据集/数组
request_ip String 123.152.251.58 请求接口的终端IP
request_time Number 1719145459 接口请求时间（默认为时间戳）
返回结果数据集
area_code Number 330200 行政区代码
province String 浙江省 省
city String 宁波市 市
area String 区（大概率为空）
info Object 天气详情
  icon String https://cache.29783.com/weather/d01.png 实时天气图标
  temp String 31.3℃ 实时温度
  weather String 多云 实时天气
  wind String 南风2级 实时风力
  humidity String 74 实时湿度
  pm25 String 25 实时PM25
  day Object 日间天气
    icon String https://cache.29783.com/weather/d04.png 日间天气图标
    temp String 33℃ 日间温度
    weather String 雷阵雨 日间天气
    wind String 4-5级 日间风力
  night Object 夜间天气
    icon String https://cache.29783.com/weather/n01.png 夜间天气图标
    temp String 26℃ 夜间温度
    weather String 多云 夜间天气
    wind String 4-5级 夜间风力
返回实例
{
    "code": 0,
    "message": "成功",
    "data": {
        "area_code": 330200,
        "province": "浙江省",
        "city": "宁波市",
        "area": "",
        "info": {
            "icon": "https://cache.29783.com/weather/d01.png",
            "temp": "31.3℃",
            "weather": "多云",
            "wind": "南风2级",
            "humidity": "74",
            "pm25": "25",
            "day": {
                "icon": "https://cache.29783.com/weather/d04.png",
                "temp": "33℃",
                "weather": "雷阵雨",
                "wind": "4-5级"
            },
            "night": {
                "icon": "https://cache.29783.com/weather/n01.png",
                "temp": "26℃",
                "weather": "多云",
                "wind": "4-5级"
            },
            "update_time": "2024-06-29 16:25"
        }
    },
    "request_ip": "123.152.251.58",
    "request_time": 1719665507
}
接口调试
接口地址
https://api.29783.com/weather/week 复制
计费单价
4点/次（≈0.004元/次）
文件下载
https://cache.29783.com/weather/weather.zip（天气图标文件）
文件下载
https://cache.29783.com/common/region-code.json（行政区划分代码文件）
返回格式
JSON
请求方式
HTTPSGETPOST
Header参数
名称 类型 必须 示例值 说明
id String 是 您自己的Api ID（注册登录后在秘钥管理中获得） 是
key String 是 您自己的Api Key（注册登录后在秘钥管理中获得） 是
请求参数
名称 类型 必须 示例值 说明
code Number 可选 330200 行政区划代码
ip String 可选 123.152.251.58 默认为请求iP,仅当用户没有提供行政区划代码时有效
返回参数
名称 类型 示例值 说明
返回结果公共参数
code Number 0 接口返回状态码，0为成功
message String 成功 接口返回文本信息
data Object/Array 返回结果数据集/数组
request_ip String 123.152.251.58 请求接口的终端IP
request_time Number 1719145459 接口请求时间（默认为时间戳）
返回结果数据集
area_code Number 330200 行政区代码
province String 浙江省 省
city String 宁波市 市
area String 区（大概率为空）
list Array 一周天气列表
  date String 2024-06-29 日期
  week String 星期六 周几
  weather String 雷阵雨转多云 天气
  wind String 4-5级 风力
  high_temp String 35℃ 最高温度
  low_temp String 27℃ 最低温度
  day_icon String https://cache.29783.com/weather/d04.png 日间图标
  night_icon String https://cache.29783.com/weather/n01.png 夜间图标
返回实例
{
    "code": 0,
    "message": "成功",
    "data": {
        "area_code": 330200,
        "province": "浙江省",
        "city": "宁波市",
        "area": "",
        "list": [
            {
                "date": "2024-06-29",
                "week": "星期六",
                "weather": "雷阵雨转多云",
                "wind": "4-5级",
                "high_temp": "35℃",
                "low_temp": "27℃",
                "day_icon": "https://cache.29783.com/weather/d04.png",
                "night_icon": "https://cache.29783.com/weather/n01.png"
            },
            {
                "date": "2024-06-30",
                "week": "星期日",
                "weather": "雷阵雨转多云",
                "wind": "4-5级",
                "high_temp": "35℃",
                "low_temp": "26℃",
                "day_icon": "https://cache.29783.com/weather/d04.png",
                "night_icon": "https://cache.29783.com/weather/n01.png"
            },
            {
                "date": "2024-07-01",
                "week": "星期一",
                "weather": "雷阵雨转多云",
                "wind": "4-5级",
                "high_temp": "34℃",
                "low_temp": "26℃",
                "day_icon": "https://cache.29783.com/weather/d04.png",
                "night_icon": "https://cache.29783.com/weather/n01.png"
            },
            {
                "date": "2024-07-02",
                "week": "星期二",
                "weather": "雷阵雨转多云",
                "wind": "4-5级",
                "high_temp": "35℃",
                "low_temp": "26℃",
                "day_icon": "https://cache.29783.com/weather/d04.png",
                "night_icon": "https://cache.29783.com/weather/n01.png"
            },
            {
                "date": "2024-07-03",
                "week": "星期三",
                "weather": "晴",
                "wind": "3-4级",
                "high_temp": "36℃",
                "low_temp": "25℃",
                "day_icon": "https://cache.29783.com/weather/d00.png",
                "night_icon": "https://cache.29783.com/weather/n00.png"
            },
            {
                "date": "2024-07-04",
                "week": "星期四",
                "weather": "晴",
                "wind": "3-4级",
                "high_temp": "38℃",
                "low_temp": "26℃",
                "day_icon": "https://cache.29783.com/weather/d00.png",
                "night_icon": "https://cache.29783.com/weather/n00.png"
            },
            {
                "date": "2024-07-05",
                "week": "星期五",
                "weather": "晴",
                "wind": "3-4级",
                "high_temp": "38℃",
                "low_temp": "25℃",
                "day_icon": "https://cache.29783.com/weather/d00.png",
                "night_icon": "https://cache.29783.com/weather/n00.png"
            }
        ]
    },
    "request_ip": "123.152.251.58",
    "request_time": 1719664775
}