接口线路类型一[集群IP接口-免费]
[接口地址1]
:当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
:当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
:当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
:[自动分发到集群接口均衡负载,但可能因网络运营商DNS缓存如果某个集群接口发生故障会造成个别地区有1天左右的故障期]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
:[专属接口+集群接口+备用接口,自动负载均衡,自动故障切换,全球CDN加速]
复制
测速
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
名称 |
参数 |
必填 |
说明 |
用户ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
用户KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
省份名称 | sheng | 是 | 要查询的省份名称,如果查询失败请去掉地名后缀。例:sheng=北京,sheng=北京市,sheng=四川省,sheng=四川 |
地点 | place | 是 | 要查询的地点,城市或区县级名称,如果查询失败请去掉地名后缀。例:place=大兴区,place=大兴,place=高新区,place=高新,place=游仙镇,place=游仙 |
返回参数说明
名称 |
参数 |
说明 |
状态码 | code | 200成功,400错误 |
消息内容 | msg | 如果状态码返回400则msg返回错误信息提示。 |
降水量 | precipitation | 降水量。 |
温度 | temperature | 温度。 |
气压 | pressure | 气压。 |
湿度 | humidity | 湿度。 |
风向 | windDirection | 风向。 |
风向度 | windDirectionDegree | 风向度。 |
风速 | windSpeed | 风速。 |
风速描述 | windScale | 风速描述。 |
地区 | place | 查询到的地区。 |
当日天气1 | weather1 | 当日天气1,例如晴转多云,那么里面的晴就是当日天气1。 |
当日天气2 | weather2 | 当日天气2,例如晴转多云,那么里面的多云就是当日天气2。 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"precipitation":0,"temperature":25.9,"pressure":952,"humidity":55,"windDirection":"西北风","windDirectionDegree":333,"windSpeed":1.4,"windScale":"微风","code":200,"place":"中国, 四川, 绵阳","weather1":"晴","weather2":"多云"}
更新记录
2024-09-26 15:52:28 - 修复查询某些地区无天气预报代码报错BUG。2024-09-22 17:20:50 - 地名无需去除后缀,由接口自动处理,如果查询失败请尝试自己去除地名后缀再试。例如四川省去除后缀则为四川,新疆维吾尔族自治区去除后缀则为新疆。2024-09-11 23:49:45 - 优化了缓存逻辑,大大提升了获取速度。2024-06-01 16:14:34 - 采用预缓存技术,大大提高该接口获取中国气象局天气数据速度。2024-05-31 22:33:17 - 新增两个当日天气状态返回参数weather1与weather2,例如晴转多云,则晴代表weather1,多云代表weather2。2024-05-31 21:41:50 - 修复某些城市查询报错BUG。2024-03-25 12:35:32 - 新增接口。