当前位置：首页 > news >正文

黄历查询-运势查询-国际法定节假日查询-API接口介绍

news 2026/7/7 4:25:10

一个接口轻松搞定法定节假日、国际节日等信息！

每到节假日前夕，总会有不少人或者公司遇到同一个问题：

今天是不是法定节假日？
明天是什么节日？
今年端午节是哪一天？
某一天对应的国际节日是什么？
如何获取完整的全年节假日列表？

那么，有没有更简单的方法维护一套准确、完整的节假日数据？
答案当然是有的！！

戳这里

#节假日列表接口有什么作用？

如果你的系统需要展示全年节假日，那么节假日列表接口就非常实用。
通过接口，可以快速获取指定年份的节假日数据。
开发者无需再手动整理全年日历，也不用担心遗漏重要节日。

请求参数

| 名称 | 类型|必须|

说明

|
| - | - |
| 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":[// 调修日列表，只有2021年之后的数据有值"20181229"]}]}}

节假日详情接口能查询哪些内容？

除了获取节假日列表之外，更常用的是节假日详情查询。
只需要传入日期，即可查询当天对应的节假日信息。
不仅能够查询法定节假日，还可以获取对应的世界国际日等相关信息。

请求参数

| 名称 | 类型|必须|

说明

例如可以实现：

查询今天是什么节日
查询指定日期节日信息
国际节日展示
节日介绍

返回样例

{"code":200,// 详见返回码说明"msg":"成功","taskNo":"526782409178028989145499",// 请求号"charge":true,// 计费标识"data":{"day":"20210501",// 查询的日期"holiday":"劳动节",// 节日名称，工作日时显示“无”，周末时显示“周末”，节日时显示节日名称"type":"3",// 1为工作日，2为周末，3为节假日"begin":"20210501",// 节日或周末开始时间，如果是工作日，此字段为空串"end":"20210503",// 节日或周末结束时间，如果是工作日，此字段为空串"holiday_remark":"5月1日—5月3日放假，共3天，5月8日（星期六）要上班。",// 节日备注"weekDay":6,// 星期几的数字"cn":"周六",// 英期几的中文名"en":"Saturday",// 星期几的英文名"h":[// 如果当日没有节日则返回空List，该字段需要请求参数中needDesc上传1才返回{"name":"世界文化发展日",// 节日名称"genus":"public",// 节日种类，public表示公众日或国际日，traditional表示传统节日"day":"0521",// 节日公历日期"lunaDay":"",// 节日的农历日期"info":"",// 节日的简介"origin":""// 节日的起源}]}}