一个接口轻松搞定法定节假日、国际节日等信息！
每到节假日前夕，总有太多个人或公司被同一个问题所困扰：
- 今天是不是法定节假日？
- 明天是什么节日？
- 今年端午节是哪一天？
- 某一天对应的国际节日是什么？
- 如何获取完整的全年节假日列表？
那么，有没有更简单的方式来维护一套准确、完整的节假日数据？
答案当然是有的！
节假日列表接口有什么作用？
如果你的系统需要展示全年放假安排，节假日列表接口就非常实用。
通过该接口，可以快速获取指定年份的节假日数据，开发者无需再手动整理全年日历，也不用担心遗漏重要的法定假日或传统节日。
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| year | String | 否 | 需要查询的年份，默认查询当年的节假日列表 |
例如可以实现：
- 展示全年节假日日历
- 节日专题页面
- 节日营销活动配置
- 节假日提醒功能
- 日历应用展示
对于需要制作节日运营页面的平台来说，提前获取完整的节假日清单，可以大幅提高开发效率并减少遗漏。
返回样例
{ "code": 200, "msg": "成功","taskNo": "526782409178028989145499", "charge": true,"data": { "count": 12, "items": [{ "begin": "20181230", "end": "20190101","holiday": "元旦","holiday_remark": "放假3天，其中2018年12月30日至2019年1月1日放假调休，2018年12月29日（周六）正常上班", "inverse_days": ["20181229"]}]}}
节假日详情接口能查询哪些内容？
除了获取节假日列表之外，更常用的是节假日详情查询。
只需传入具体日期，即可查询当天对应的节假日信息。不仅能识别法定节假日，还能获取对应的世界国际日、传统节日等相关内容。
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| date | String | 否 | 查询的日期，默认当天 |
| needDesc | String | 否 | 是否需要返回当日公众日、国际日和我国传统节日的简介，1-返回，默认不返回 |
例如可以实现：
- 查询今天是什么节日
- 查询指定日期节日信息
- 国际节日展示
- 节日介绍
返回样例
{ "code": 200, "msg": "成功","taskNo": "526782409178028989145499","charge": true, "data": { "day": "20210501", "holiday": "劳动节","type": "3", "begin": "20210501", "end": "20210503", "holiday_remark": "5月1日—5月3日放假，共3天，5月8日（星期六）要上班。", "weekDay": 6, "cn": "周六", "en": "Saturday", "h": [{ "name": "世界文化发展日", "genus": "public", "day": "0521", "lunaDay": "", "info": "", "origin": "" }]}}
一个接口，可以应用到哪些行业？
- 在线旅游平台
- 酒店预订系统
- 火车票、机票预订
- 企业OA办公系统
- 日程管理工具
- 企业ERP系统
- 电商促销平台
- 教育考试平台
- 智能提醒应用
为什么越来越多开发者选择接口获取节假日信息？
对于需要构建日历、提醒、营销、预约、排班、旅游预订等功能的系统来说，这类节假日查询API能有效减少数据维护成本，提高开发效率，同时也能为用户提供更智能、更丰富的产品体验。
相比之下，接口方式具有不少优势：
- 节假日数据获取更加方便
- 节日信息查询更加灵活
- 减少人工维护成本
- 方便快速接入现有系统
- 可用于多种业务场景
- 提高开发效率
