基本说明：
| 接口地址：https://way.jd.com/he/freecity |
|---|
| 返回格式：json |
| 请求方式：get/post |
| 请求示例：https://way.jd.com/he/freecity?city=beijing&appkey=APPKEY |
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appkey | string | 必填 | 该平台的appkey 扫码关注公众号 |
| city | string | 必填 | 可通过城市中英文名称、ID和IP地址进行，例如city=北京，city=beijing，city=CN101010100，city= 60.194.130.1 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| basic | string | 基本信息 |
| city | string | 城市名 |
| cnty | string | 国家 |
| lat | string | 纬度 |
| prov | string | 省份 |
| lon | string | 经度 |
| id | string | 城市ID |
JSON返回示例：
{
"code": "10000",
"charge": false,
"msg": "查询成功",
"result": {
"HeWeather5": [{
"basic": {
"city": "北京",
"cnty": "中国",
"id": "CN101010100",
"lat": "39.904000",
"lon": "116.391000",
"prov": "直辖市"
},
"status": "ok"
}]
}
}
服务级错误码参照
| 错误码 | 说明 |
|---|---|
| 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=freecity&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=freecity&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))
}