未来3天天气
其他 官方文档
未来 3 天天气预报,包括白天天气现象文字及代码、晚间天气现象文字及代码、当天最高温度和最低温度、风向风速
基本说明:
接口地址:https://api.seniverse.com/v3/weather/daily.json
返回格式:json
请求方式:get/post
请求示例:https://api.seniverse.com/v3/weather/daily.json?key=youkey&location=beijing&language=zh-Hans&unit=c
请求参数说明:
名称 类型 必填 说明
key string 必填 API的密钥 扫码关注公众号
location string 必填 所查询的位置
language string 选填 语言,默认zh-Hans
unit string 选填 单位,默认c
返回参数说明:
名称 类型 说明
date string 日期
text_day string 白天天气现象文字
code_day int 白天天气现象代码
text_night string 晚间天气现象文字
code_night int 晚间天气现象代码
high int 当天最高温度
low int 当天最低温度
precip int 降水概率,范围0~100
wind_direction string 风向文字
wind_direction_degree int 风向角度,范围0~360,0为正北,90为正东,180为正南,270为正西
wind_speed int 风速,单位为km/h公里每小时或mph英里每小时
wind_scale int 降水量,单位mm
rainfall int 风力等级
humidity int 相对湿度,0~100,单位为百分比
JSON返回示例:
{
	"results": [{
		"location": {
			"id": "WX4FBXXFKE4F",
			"name": "北京",
			"country": "CN",
			"path": "北京,北京,我们",
			"timezone": "Asia/Shanghai",
			"timezone_offset": "+08:00"
		},
		"daily": [{
			"date": "2022-05-06",
			"text_day": "小雨",
			"code_day": "13",
			"text_night": "晴",
			"code_night": "1",
			"high": "23",
			"low": "10",
			"rainfall": "5.40",
			"precip": "0.93",
			"wind_direction": "东北",
			"wind_direction_degree": "45",
			"wind_speed": "23.4",
			"wind_scale": "4",
			"humidity": "48"
		}, {
			"date": "2022-05-07",
			"text_day": "多云",
			"code_day": "4",
			"text_night": "小雨",
			"code_night": "13",
			"high": "20",
			"low": "10",
			"rainfall": "4.71",
			"precip": "0.93",
			"wind_direction": "西南",
			"wind_direction_degree": "225",
			"wind_speed": "8.4",
			"wind_scale": "2",
			"humidity": "56"
		}, {
			"date": "2022-05-08",
			"text_day": "多云",
			"code_day": "4",
			"text_night": "晴",
			"code_night": "1",
			"high": "17",
			"low": "10",
			"rainfall": "0.00",
			"precip": "0.00",
			"wind_direction": "南",
			"wind_direction_degree": "180",
			"wind_speed": "3.0",
			"wind_scale": "1",
			"humidity": "91"
		}],
		"last_update": "2022-05-06T08:00:00+08:00"
	}]
}
服务级错误码参照
错误码 说明
AP010001 API 请求参数错误
AP010002 没有权限访问这个 API 接口
AP010003 API 密钥 key 错误
AP010004 签名错误
AP010005 你请求的 API 不存在
AP010006 没有权限访问这个地点
AP010007 JSONP 请求需要使用签名验证方式
AP010008 没有绑定域名
AP010009 API 请求的 user-agent 与你设置的不一致
AP010010 没有这个地点
AP010011 无法查找到指定 IP 地址对应的城市
AP010012 你的服务已经过期
AP010013 访问量余额不足
AP010014 访问频率超过限制
AP010015 暂不支持该城市的车辆限行信息
AP010016 暂不支持该城市的潮汐数据
AP010017 请求的坐标超出支持的范围
AP100001 系统内部错误:数据缺失
AP100002 系统内部错误:数据错误
AP100003 系统内部错误:服务内部错误
AP100004 系统内部错误:网关错误
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2022/04/08 11:38
 */
class freeApi
{
    private $apiUrl;

    public function __construct()
    {
        $this->apiUrl = 'https://api.seniverse.com/v3/weather/daily.json?key=youkey&location=beijing&language=zh-Hans&unit=c&start=0&days=5';
    }

    /**
     * 获取结果
     * @return array
     */
    public function getResult()
    {
        return file_get_contents($this->apiUrl);
    }
}
package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

const (
	APIURL   = "https://api.seniverse.com/v3/weather/daily.json?key=youkey&location=beijing&language=zh-Hans&unit=c&start=0&days=5"
)

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))
}