历史天气

说明

说明：
1. 历史天气数据接口可获取自2019-01-01之后，包括当天(若需要2015-2019的数据请联系客服说明需求)。 
2. 历史数据来自实时天气(weather.realtime)中实时数据归档存储.
3. 历史数据支持跨度较大,极端情况下会存在极小部分数据丢失的情况; 另外在行政区重新划分调整时(新增或下线的相关城市)，在某此时间节点会出现一定的数据断层,城市列表可参考weather.city接口中upddate(更新时间)、mk(当前可用状态)和remark(备注)栏位。
4. 气象数据并非每小时都会更新,只有存在更新的情形时才会插入新的数据.
5. 因系统更新原因2019年3月15前数据无风速,能见度,降雨量,气压hpa.
6. 近期存在恶意大量注册帐号采集历史数据行为,即日起关闭历史天气试用功能,如需试用请购买10元流量包套餐.

扣费扣量特别说明（扣量: 包月套餐扣可用配额次数，流量包套餐扣可用次数）
1. result.dtCount节点值为数据条数，每5条数据或不足5条扣量1次；例如：数据条数为4扣量1次，为6扣量2次。

测试示例：https://sapi.k780.com/?app=weather.history&weaId=1&dateYmd=20220101-20220102&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json (示例中sign会不定期调整)

调用方式

Get/Post

请求url

 HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com

请求参数

Json请求示例

http://api.k780.com/?app=weather.history&weaId=城市编号&dateYmd=查询的日期段&appkey=APPKEY&sign=SIGN&format=json

Json返回示例

1.正常返回
{
    success: "1",
    result: {
        dtQuery: "20220101-20220102",
        dtCount: "39",
        dtAppend: {
        weaId: "1",
        cityNm: "北京",
        cityId: "101010100",
        areaNm_1: "北京",
        areaNm_2: "城区",
        areaNm_3: ""
    },
    dtList: [{
        upTime: "2022-01-01 09:15:00", /*数据更新时间*/
        /*以下字段解释与weather.realtime中一致*/
        wtId: "2",  /*天气编号 天气类型 wtId*/
        wtNm: "多云", /*天气 天气类型 wtNm*/
        wtIcon: "01", /*天气图标 天气类型 wtIcon*/
        wtTemp: "-2", /*温度℃*/
        wtHumi: "57", /*湿度%*/
        wtWindId: "1", /*风向ID (见面页上方风向ID对照表)*/
        wtWindNm: "东北风", /*风向*/
        wtWinp: "1", /*风力 单位:级 (非风力ID,该值直接为风力级数)*/ 
        wtWins: "3",/*风速 单位:km/h*/
        wtAqi: "52", /*pm2.5 aqi*/
        wtVisibility: "10.00", /*能见度km*/
        wtRainfall: "0.00", /*降雨量mm 注:距离上次更新至upTime时间的降雨量*/
        wtPressurel: "1021" /*气压hpa*/
    },
   ....
   ]
}

2.异常或无数据
{
    success: "0",
    msgid: "...",
    msg: "..."
}
..............

示例代码

• PHP
• Python
• Java
• Curl

<?php
header("Content-Type:text/html;charset=UTF-8");
function nowapiRequest($postData,&$errMsg=''){
    $apiUrl     = 'https://sapi.k780.com/';
    $useContext = stream_context_create(array(
        'http' => array(
            'method'  => 'POST',
            'header'  => 'Content-type:application/x-www-form-urlencoded',
            'content' => http_build_query($postData)
        )
    ));
    if(!$resData=file_get_contents($apiUrl,false,$useContext)){
        $errMsg = 'ERR_CONNECT';
        return false;
    }
    if(!$arrData=json_decode($resData,true)){
        $errMsg = 'ERR_DECODE';
        return false;
    }
    if($arrData['success']!=1){
        $errMsg = $arrData['msgid'].' '.$arrData['msg'];
        return false;
    }
    return $arrData['result'];
}

$postData['app'] = 'weather.history';
$postData['weaId'] = '城市编号';
$postData['dateYmd'] = '查询的日期段';
$postData['appkey'] = '10003';//替换成自己的appkey
$postData['sign'] = 'b59bc3ef6191eb9f747dd4e83c99f2a4';//替换成自己的sign
$postData['format'] = 'json';
$result = nowapiRequest($postData,$errMsg);
print_r($errMsg);
print_r($result);

#python
import json,urllib
from urllib import urlencode

url = 'http://api.k780.com'
params = {
  'app' : 'weather.history',
  'weaId' : '城市编号',
  'dateYmd' : '查询的日期段',
  'appkey' : 'APPKEY',
  'sign' : 'SIGN',
  'format' : 'json',
}
params = urlencode(params)

f = urllib.urlopen('%s?%s' % (url, params))
nowapi_call = f.read()
#print content
a_result = json.loads(nowapi_call)
if a_result:
  if a_result['success'] != '0':
    print a_result['result'];
  else:
    print a_result['msgid']+' '+a_result['msg']
else:
  print 'Request nowapi fail.';

import java.net.*;
import java.io.*;

public class test{
    public static void main(String args[]) throws Exception {
        URL u=new URL("http://api.k780.com/?app=weather.history&weaId=城市编号&dateYmd=查询的日期段&appkey=APPKEY&sign=SIGN&format=json");
        InputStream in=u.openStream();
        ByteArrayOutputStream out=new ByteArrayOutputStream();
        try {
            byte buf[]=new byte[1024];
            int read = 0;
            while ((read = in.read(buf)) > 0) {
                out.write(buf, 0, read);
            }
        }  finally {
            if (in != null) {
                in.close();
            }
        }
        byte b[]=out.toByteArray( );
        System.out.println(new String(b,"utf-8"));
    }
}

curl "http://api.k780.com/?app=weather.history&weaId=城市编号&dateYmd=查询的日期段&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"