基本说明：
| 接口地址：https://way.jd.com/he/freeweather |
|---|
| 返回格式：json |
| 请求方式：get/post |
| 请求示例：https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY |
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appkey | string | 必填 | 该平台的appkey 扫码关注公众号 |
| city | string | 必填 | 可通过城市中英文名称、ID和IP地址进行，例如city=北京，city=beijing，city=CN101010100，city= 60.194.130.1 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| HeWeather5 | string | 和风标识 |
| suggestion | string | 生活指数 |
| drsg | string | 穿衣指数 |
| txt | string | 数据详情 |
| brf | string | 生活指数简介 |
| uv | string | 紫外线指数 |
| comf | string | 舒适度指数 |
| flu | string | 感冒指数 |
| sport | string | 运动指数 |
| trav | string | 旅游指数 |
| cw | string | 洗车指数 |
| status | string | 状态码 |
| hourly_forecast | string | 每小时预报 |
| tmp | string | 温度 |
| pop | string | 降水概率 |
| pres | string | 大气压 |
| wind | string | 风力情况 |
| deg | string | 风向（360度） |
| sc | string | 风力等级 |
| spd | string | 风速 |
| dir | string | 风向 |
| hum | string | 相对湿度 |
| date | string | 日期 |
| cond | string | 天气状况 |
| code | string | 天气状况代码 |
| now | string | 实况天气 |
| fl | string | 感冒指数 |
| pcpn | string | 降水量 |
| vis | string | 能见度 |
| aqi | string | AQI |
| city | string | 城市名 |
| pm25 | string | PM2.5 |
| pm10 | string | PM10 |
| co | string | CO |
| so2 | string | SO2 |
| no2 | string | NO2 |
| qlty | string | 空气质量 |
| o3 | string | O3 |
| basic | string | 基本信息 |
| id | string | 城市ID |
| cnty | string | 国家 |
| lat | string | 纬度 |
| update | string | 更新时间 |
| loc | string | 当地时间 |
| utc | string | UTC时间 |
| lon | string | 经度 |
| daily_forecast | string | 天气预报 |
| txt_d | string | 白天天气状况描述 |
| txt_n | string | 夜间天气状况描述 |
| code_d | string | 白天天气状况代码 |
| code_n | string | 夜间天气状况代码 |
| astro | string | 天文指数 |
| ms | string | 月落时间 |
| ss | string | 日落时间 |
| sr | string | 日出时间 |
| mr | string | 月升时间 |
| max | string | 最高温度 |
| min | string | 最低温度 |
JSON返回示例：
{
"code": "10000",
"charge": false,
"msg": "查询成功",
"result": {
"HeWeather5": [{
"aqi": {
"city": {
"aqi": "40",
"qlty": "优",
"pm25": "28",
"pm10": "19",
"no2": "31",
"so2": "5",
"co": "0.8",
"o3": "42"
}
},
"basic": {
"city": "上海",
"cnty": "中国",
"id": "CN101020100",
"lat": "31.23170662",
"lon": "121.47264099",
"update": {
"loc": "2020-11-27 10:17",
"utc": "2020-11-27 02:17"
}
},
"daily_forecast": [{
"astro": {
"mr": "15:11",
"ms": "03:25",
"sr": "06:32",
"ss": "16:51"
},
"cloud": "55",
"cond": {
"code_d": "305",
"code_n": "101",
"txt_d": "小雨",
"txt_n": "多云"
},
"date": "2020-11-27",
"hum": "56",
"pcpn": "1.0",
"pop": "55",
"pres": "1032",
"tmp": {
"max": "14",
"min": "9"
},
"uv": "1",
"vis": "24",
"wind": {
"deg": "0",
"dir": "北风",
"sc": "3-4",
"spd": "19"
}
}, {
"astro": {
"mr": "15:41",
"ms": "04:19",
"sr": "06:33",
"ss": "16:51"
},
"cloud": "4",
"cond": {
"code_d": "104",
"code_n": "101",
"txt_d": "阴",
"txt_n": "多云"
},
"date": "2020-11-28",
"hum": "67",
"pcpn": "0.0",
"pop": "4",
"pres": "1030",
"tmp": {
"max": "12",
"min": "7"
},
"uv": "1",
"vis": "25",
"wind": {
"deg": "0",
"dir": "北风",
"sc": "3-4",
"spd": "16"
}
}, {
"astro": {
"mr": "16:13",
"ms": "05:14",
"sr": "06:34",
"ss": "16:51"
},
"cloud": "2",
"cond": {
"code_d": "101",
"code_n": "100",
"txt_d": "多云",
"txt_n": "晴"
},
"date": "2020-11-29",
"hum": "60",
"pcpn": "0.0",
"pop": "2",
"pres": "1032",
"tmp": {
"max": "12",
"min": "8"
},
"uv": "3",
"vis": "25",
"wind": {
"deg": "45",
"dir": "东北风",
"sc": "3-4",
"spd": "15"
}
}, {
"astro": {
"mr": "16:50",
"ms": "06:10",
"sr": "06:35",
"ss": "16:51"
},
"cloud": "1",
"cond": {
"code_d": "101",
"code_n": "101",
"txt_d": "多云",
"txt_n": "多云"
},
"date": "2020-11-30",
"hum": "62",
"pcpn": "0.0",
"pop": "1",
"pres": "1031",
"tmp": {
"max": "15",
"min": "10"
},
"uv": "3",
"vis": "25",
"wind": {
"deg": "45",
"dir": "东北风",
"sc": "3-4",
"spd": "16"
}
}, {
"astro": {
"mr": "17:31",
"ms": "07:07",
"sr": "06:36",
"ss": "16:51"
},
"cloud": "8",
"cond": {
"code_d": "104",
"code_n": "101",
"txt_d": "阴",
"txt_n": "多云"
},
"date": "2020-12-01",
"hum": "64",
"pcpn": "0.0",
"pop": "8",
"pres": "1026",
"tmp": {
"max": "15",
"min": "11"
},
"uv": "3",
"vis": "24",
"wind": {
"deg": "45",
"dir": "东北风",
"sc": "1-2",
"spd": "6"
}
}, {
"astro": {
"mr": "18:18",
"ms": "08:03",
"sr": "06:37",
"ss": "16:51"
},
"cloud": "25",
"cond": {
"code_d": "104",
"code_n": "101",
"txt_d": "阴",
"txt_n": "多云"
},
"date": "2020-12-02",
"hum": "59",
"pcpn": "0.0",
"pop": "25",
"pres": "1027",
"tmp": {
"max": "15",
"min": "10"
},
"uv": "1",
"vis": "25",
"wind": {
"deg": "45",
"dir": "东北风",
"sc": "3-4",
"spd": "16"
}
}, {
"astro": {
"mr": "19:11",
"ms": "08:58",
"sr": "06:37",
"ss": "16:51"
},
"cloud": "24",
"cond": {
"code_d": "104",
"code_n": "104",
"txt_d": "阴",
"txt_n": "阴"
},
"date": "2020-12-03",
"hum": "73",
"pcpn": "0.0",
"pop": "24",
"pres": "1030",
"tmp": {
"max": "13",
"min": "8"
},
"uv": "2",
"vis": "24",
"wind": {
"deg": "0",
"dir": "北风",
"sc": "3-4",
"spd": "16"
}
}],
"hourly_forecast": [{
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-27 13:00",
"hum": "65",
"pop": "14",
"pres": "1032",
"tmp": "13",
"wind": {
"deg": "339",
"dir": "西北风",
"sc": "3-4",
"spd": "20"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-27 16:00",
"hum": "64",
"pop": "10",
"pres": "1031",
"tmp": "12",
"wind": {
"deg": "4",
"dir": "北风",
"sc": "4-5",
"spd": "25"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-27 19:00",
"hum": "60",
"pop": "0",
"pres": "1032",
"tmp": "11",
"wind": {
"deg": "6",
"dir": "北风",
"sc": "3-4",
"spd": "20"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-27 22:00",
"hum": "54",
"pop": "0",
"pres": "1033",
"tmp": "11",
"wind": {
"deg": "7",
"dir": "北风",
"sc": "3-4",
"spd": "18"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-28 01:00",
"hum": "54",
"pop": "0",
"pres": "1033",
"tmp": "10",
"wind": {
"deg": "9",
"dir": "北风",
"sc": "3-4",
"spd": "18"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-28 04:00",
"hum": "53",
"pop": "0",
"pres": "1032",
"tmp": "9",
"wind": {
"deg": "5",
"dir": "北风",
"sc": "3-4",
"spd": "16"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-28 07:00",
"hum": "55",
"pop": "0",
"pres": "1031",
"tmp": "10",
"wind": {
"deg": "7",
"dir": "北风",
"sc": "3-4",
"spd": "16"
}
}, {
"cond": {
"code": "101",
"txt": "多云"
},
"date": "2020-11-28 10:00",
"hum": "48",
"pop": "0",
"pres": "1031",
"tmp": "11",
"wind": {
"deg": "9",
"dir": "北风",
"sc": "3-4",
"spd": "16"
}
}],
"now": {
"cond": {
"code": "305",
"txt": "小雨"
},
"dew": "11",
"fl": "11",
"hum": "97",
"pcpn": "0.2",
"pres": "1027",
"tmp": "11",
"vis": "5",
"wind": {
"deg": "0",
"dir": "北风",
"sc": "0",
"spd": "0"
}
},
"status": "ok",
"suggestion": {
"air": {
"brf": "良",
"txt": "气象条件有利于空气污染物稀释、扩散和清除，可在室外正常活动。"
},
"comf": {
"brf": "较舒适",
"txt": "白天有少量雨，风力较强，这种天气条件下，人们会感到有些凉意，但大部分人完全可以接受。"
},
"cw": {
"brf": "不宜",
"txt": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。"
},
"drsg": {
"brf": "较冷",
"txt": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。"
},
"flu": {
"brf": "易发",
"txt": "天冷风大且空气湿度大，易发生感冒，请注意适当增加衣服，加强自我防护避免感冒。"
},
"sport": {
"brf": "较不宜",
"txt": "有降水，且风力较强，推荐您在室内进行各种健身休闲运动；若坚持户外运动，请注意防风保暖。"
},
"trav": {
"brf": "适宜",
"txt": "有降水，虽然风稍大，但温度适宜，适宜旅游，可不要错过机会呦！"
},
"uv": {
"brf": "最弱",
"txt": "属弱紫外线辐射天气，无需特别防护。若长期在户外，建议涂擦SPF在8-12之间的防晒护肤品。"
}
}
}]
}
}
服务级错误码参照
| 错误码 | 说明 |
|---|---|
| 10000 | 查询成功 |
| 10001 | 错误的请求appkey |
| 11010 | 商家接口调用异常，请稍后再试 |
| 11030 | 商家接口返回格式有误 |
| 10003 | 不存在相应的数据信息 |
| 10004 | URL上appkey参数不能为空 |
| 10010 | 接口需要付费，请充值 |
| 10020 | 万象系统繁忙，请稍后再试 |
| 10030 | 调用万象网关失败， 请与万象联系 |
| 10040 | 超过每天限量，请明天继续 |
| 10050 | 用户已被禁用 |
| 10060 | 提供方设置调用权限，请联系提供方 |
| 10070 | 该数据只允许企业用户调用 |
| 10090 | 文件大小超限，请上传小于1M的文件 |
完整教学代码示例
<?php
/**
* Created by PhpStorm.
* User: FZS
* Time: 2020/12/01 22:26
*/
class freeApi
{
private $apiUrl;
public function __construct()
{
$this->apiUrl = 'https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY';
}
/**
* 获取结果
* @return array
*/
public function getResult()
{
return file_get_contents($this->apiUrl);
}
}package main
import (
"fmt"
"io/ioutil"
"log"
"net/http"
)
const (
APIURL = "https://way.jd.com/he/freeweather?city=beijing&appkey=APPKEY"
)
func main() {
queryUrl := fmt.Sprintf("%s",APIURL)
resp, err := http.Get(queryUrl)
if err != nil {
log.Println(err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}