历史上的今天
BERRYAPI 官方文档
历史上的今天
基本说明:
接口地址:https://api.berryapi.net/?service=App.History.Today
返回格式:json
请求方式:post
请求示例:https://api.berryapi.net/?service=App.History.Today
请求参数说明:
名称 类型 必填 说明
AppKey string 必填 到平台注册时生成的密钥
md string 必填 短日期格式,月日:0101
返回参数说明:
名称 类型 说明
data string 日期
day string
event string 事件
month string 月份
title string 事件标题
JSON返回示例:
{
	"ret": 200,
	"data": {
		"result": [{
			"date": "17711015",
			"day": 15,
			"event": "  渥巴锡,清代卫拉特蒙古土尔扈特部首领,因不堪忍受沙俄的统治,率部东归,回到祖国怀抱。明崇祯三年(公元1630年),为了躲避势力日益强大的准噶尔部的威胁,漠西卫拉特(瓦喇)蒙古土尔扈特部首领和鄂尔勒克,率领土尔扈特大部及部分和硕特、杜尔伯特约五万帐西迁至额济勒河(今俄罗斯伏尔加河)流域游牧。虽然摆脱了准噶尔部的威胁,但好景不长,他们很快又坠入了沙皇俄国的统治之下。特别是阿玉奇汗和策伦敦罗卜之后,土尔扈特人的处境更为艰难。俄国不仅迫使他们称臣,而且还直接干预其汗位的继承等内部事务。引起了他们的强烈不满。1761年土尔扈特部首领敦罗卜喇什去世,其17岁的儿子渥巴锡继承汗位。渥巴锡继位后,沙皇俄国更变本加利地奴役和控制土尔扈特人,缩小他们的牧场,征调大批土尔扈特兵,与土耳其人进行战争,让他们为俄国卖命,使数万土尔扈特人丧生战常苦难深重的土尔扈特人民在热切盼望早日摆脱沙皇的统治。在此情况下,渥巴锡与策伯克多尔济、舍棱等首领会商,毅然决定东返故土,回归祖国。实现他们及土尔扈特部人民多年的愿望。1770(乾隆三十五年)年底,渥巴锡成功地麻痹了沙俄当局的警觉,开始集结部众,作好东归的准备工作。1771年1月5日(乾隆三十五年十一月二十日),采取乘敌不备,先发制人的策略,派精锐部队突袭歼灭俄国驻军。然后率部3万3千多户,17万余人分成三路启程东返,迅速穿过冰封的乌拉尔河,进入大雪覆盖的哈萨克草原。摆脱了俄军和歌萨克骑兵的追击。半年后,经过长途跋涉,历经种种磨难,这支出发时十七万人的部落回到中国只剩下一万多人。付出巨大牺牲的土尔扈特人终于到达新疆伊犁,回到了向往已久的祖国。清政府派员前往伊犁迎接渥巴锡及其部众,并将其安置于伊犁附近,予以赈济,后又划定牧场,使其得以休养生息,为褒奖他率部回归,同年9月乾隆皇帝在承德避暑山庄接见渥巴锡等人,并封其为卓里克图汗,负责管辖裕勒都斯旧土尔扈特蒙古乌纳恩素珠克图盟南路四旗(今新疆维吾尔自治区巴音郭楞蒙古自治州),任盟长,公元1775年1月9日(乾隆三十九年十二月八日),渥巴锡病逝,终年三十三岁。长子策凌那木扎勒袭位。渥巴锡率部回归的英雄壮举,震动了当时的中国与西方世界,正如爱尔兰作家德尼赛在《鞑靼人的反叛》一书中所说的那样:“从有最早的历史记录以来,没有一桩伟大的事业能像上个世纪后半期一个主要鞑靼民族跨越亚洲草原向东迁逃那样轰动于世,那样令人激动的了。”渥巴锡及土尔扈特人的回归,为我们统一的多民族国家做出了重大贡献。这次史诗般的壮举,及他们在这次壮举中所表现出来的炽热的爱国主义精神、顽强不息的斗争意志,将永载史册,\n",
			"id": "569881b6590146d407332eb7",
			"month": 10,
			"title": "土尔扈特台吉渥巴锡回归入觐"
		}],
		"msg": "success"
	},
	"msg": ""
}
服务级错误码参照
错误码 说明
- -
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2019/11/02 21:31
 */
//----------------------------------
// 历史上的今天 调用类
//----------------------------------
class freeApi{
    private $apiUrl;
    private $appKey;

    public function __construct($appKey){
        $this->appKey = $appKey;
        $this->apiUrl = 'https://api.berryapi.net/?service=App.History.Today';
    }
    /**
     * 获取结果
     * @return array
     */
    public function getResult(){
        $paras = [
          'AppKey' => $this->appKey,
          'md' => '0101',
        ];
        return $this->freeApiCurl($this->apiUrl,$paras);
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false){
        $headers = array('Content-Type: application/x-www-form-urlencoded');
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url); // 要访问的地址
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); // 对认证证书来源的检查
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0); // 从证书中检查SSL加密算法是否存在
        curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1); // 使用自动跳转
        curl_setopt($curl, CURLOPT_AUTOREFERER, 1); // 自动设置Referer
        curl_setopt($curl, CURLOPT_POST, 1); // 发送一个常规的Post请求
        curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params)); // Post提交的数据包
        curl_setopt($curl, CURLOPT_TIMEOUT, 30); // 设置超时限制防止死循环
        curl_setopt($curl, CURLOPT_HEADER, 0); // 显示返回的Header区域内容
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // 获取的信息以文件流的形式返回
        curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
        $result = curl_exec($curl); // 执行操作
        if (curl_errno($curl)) {
            echo 'Errno'.curl_error($curl);//捕抓异常
        }
        curl_close($curl); // 关闭CURL会话
        return $result;
    }
}