稳定、快速的API服务

节假日查询，我们致力于为用户提供专业的免费API数据接口服务

节假日查询 v1.0

最后更新: 2026-09-02 12:12:08

可查询节假日信息，以及日期对应的节日名称介绍。

免费 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址：
https://api.shuliancloud.com/v10/holiday/list
请求方式： POST
返回格式： JSON

调用统计

0
今日调用
0
总调用次数
请求示例 https://api.shuliancloud.com/v10/holiday/list

点击右侧按钮复制完整请求地址，参数值请替换为实际有效值

请求参数 （暂无请求参数）

参数名 是否必填 参数类型 参数说明
暂无请求参数信息

请求参数说明

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名，<a href='#sign'>签名算法说明</a>  |
| year  | varchar  | 否  | 需要查询的年份,默认查询当年的节假日列表 |

返回参数 （暂无返回参数）

参数名 参数类型 参数说明
暂无返回参数信息

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，其它为失败状态码   | 
| msg  | code对应的说明描述   | 
| data  | 验证结果详细信息|

返回示例 

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "orderNo": "rf0a8gkjjucpig1meh",
        "ret_code": "0",   //0成功其它失败
        "remark": "seccess",
        "data": [
            {
                "begin": "20220101", //节假日的开始时间
                "end": "20220103",  //节假日的结束时间
                "holiday": "元旦节", //节假日名称
                "holiday_remark": "2022年1月1日至3日放假，共3天。",  //节假日描述
                "inverse_days": []   //调修日列表，只有2021年之后的数据有值
            },
            {
                "begin": "20220131",
                "end": "20220206",
                "holiday": "春节",
                "holiday_remark": "1月31日至2月6日放假调休，共7天。1月29日（星期六）、1月30日（星期日）上班。",
                "inverse_days": [
                    "20220129",
                    "20220130"
                ]
            },
            {
                "begin": "20220403",
                "end": "20220405",
                "holiday": "清明节",
                "holiday_remark": "4月3日至5日放假调休，共3天。4月2日（星期六）上班。",
                "inverse_days": [
                    "20220402"
                ]
            },
            {
                "begin": "20220430",
                "end": "20220504",
                "holiday": "劳动节",
                "holiday_remark": "4月30日至5月4日放假调休，共5天。4月24日（星期日）、5月7日（星期六）上班。",
                "inverse_days": [
                    "20220424",
                    "20220507"
                ]
            },
            {
                "begin": "20220603",
                "end": "20220605",
                "holiday": "端午节",
                "holiday_remark": "6月3日至5日放假，共3天。",
                "inverse_days": []
            },
            {
                "begin": "20220910",
                "end": "20220912",
                "holiday": "中秋节",
                "holiday_remark": "9月10日至12日放假，共3天。",
                "inverse_days": []
            },
            {
                "begin": "20221001",
                "end": "20221007",
                "holiday": "国庆节",
                "holiday_remark": "10月1日至7日放假调休，共7天。10月8日（星期六）、10月9日（星期日）上班。",
                "inverse_days": [
                    "20221008",
                    "20221009"
                ]
            }
        ]
    }
}