使用须知

  • 这是由本人利用业余时间开发的节假日API
  • 在自己的兴趣爱好项目中使用,并免费提供给同样需要的人
  • 节假日每年我都会尽快更新
  • 如果发现某个节假日配置错误或没有配置,欢迎联系我
  • 所有接口都需要token值,如要使用,请联系我,我将免费提供
  • 更多功能,正在开发中

联系方式

  • ltfred@163.com

API文档

1. 获取某年的的法定节假日信息

1.1 接口

URL 请求方式
https://www.ltfred.com/api/v2/holiday/year GET

1.2 参数

参数 描述
year 指定年的字符串,格式为2020,支持2020年-2021年,不传的话默认为今年
token token

1.3 示例

https://www.ltfred.com/api/v2/holiday/year?year=2020&token=ltfred123

{
    "status": 0,  // 0查询成功,-1查询失败
    "data": {
        "year": "2020",  // 查询的年
        "message": [
            {
                "name": "元旦节",  // 节日名称
                "date": "2020-01-01",  // 放假时间
                "duration": "01月01日~01月01日",  // 放假区间
                "rest": "无调休",  // 调休时间
                "days": "1天"  // 总放假天数
            },
        ]
    }
}

2. 查询指定日期节假日信息

2.1 接口

URL 请求方式
https://www.ltfred.com/api/v2/holiday/info GET

2.2 参数

参数 描述
date 指定日期的字符串,格式为2020-01-01,支持2020-01-01以后日期,不传的话默认为今天
token token

2.3 示例

https://www.ltfred.com/api/v2/holiday/info?date=2020-01-01&token=ltfred123

{
    "status": 0,
    "data": {
        "date": "2020-01-01",  // 查询的日期
        "message": "今天是元旦节呢,好好休息一下吧!"  // 节假日信息
    }
}

3. 获取某个日期的下一个节假日

3.1 接口

URL 请求方式
https://www.ltfred.com/api/v2/holiday/next GET

3.2 参数

参数 描述
date 指定日期的字符串,格式为2020-01-01,支持2020-01-01以后日期,不传的话默认为今天
token token

3.3 示例

https://www.ltfred.com/api/v2/holiday/next?date=2020-01-01&token=ltfred123

// 查询到假期时返回
{
    "status":0,  // 状态码
    "data":{
        "date": "2020-01-24",  // 下一法定假日放假时间
        "duration":"01月24日~02月02日",  // 下一个节假日的放假区间
        "rest":"01月19日(周日)",  // 下一个节假日的调休
        "days":"10天",   // 下一个节假日的放假天数
        "message":"下一个节假日是春节, 距离今天还有23天"  // 下一个节假日信息
    }
}

// 没有查询到假期时返回
{
    "status": 0,
    "data": {
        "message": "今年没有假期了哦"
    }
}

更新日志

2020-10-27

  • 为所有接口添加了token验证

2020-10-21

  • 添加2021年节假日
  • 当前年没有假期时,会尝试获取下一年的假期

2020-10-18

  • 修改节假日返回数据

2020-10-16

  • 添加下一个节假日信息接口

2020-10-14

  • 修改接口传参方式

2020-10-13

  • API上线

版权声明:如无特殊说明,文章均为本站原创,转载请注明出处

本文链接:https://www.ltfred.com/article/holiday-api/