节日假期接口

1. 节日假期

1.1 节日列表

• 接口地址

POST /v1/holiday/getFestival

• 请求参数

名称	类型	是否必需	示例	描述
start_date	string	N	"2025-02-20"	开始日期；默认当天

• 返回结果

名称	类型	描述
id	int	节日ID
name	string	节日名称
holiday_start_date	string	节日开始日期
holiday_end_date	string	节日结束日期

• 返回示例

{
    "error_code": 0,
    "description": "success",
    "error_msg": "success",
    "data": [
        {
            "id": 10,
            "name": "清明节",
            "holiday_start_date": "2025-04-03",
            "holiday_end_date": "2025-04-06"
        },
        {
            "id": 11,
            "name": "劳动节",
            "holiday_start_date": "2025-04-30",
            "holiday_end_date": "2025-05-05"
        },
        {
            "id": 12,
            "name": "端午节",
            "holiday_start_date": "2025-05-30",
            "holiday_end_date": "2025-06-02"
        },
        {
            "id": 14,
            "name": "中秋节",
            "holiday_start_date": "2025-10-06",
            "holiday_end_date": "2025-10-06"
        },
        {
            "id": 13,
            "name": "国庆节",
            "holiday_start_date": "2025-09-30",
            "holiday_end_date": "2025-10-08"
        }
    ]
}

• 使用示例

1.2 日历假期

• 接口地址

POST /v1/holiday/getHoliday

• 请求参数

名称	类型	是否必需	示例	描述
start_date	string	Y	"2025-09-26"	日历开始时间，不能小于2年前
end_date	string	Y	"2025-10-16"	日历结束时间，不能大于2年后，时间间隔小于30天

• 返回结果

名称	类型	描述
data	object	日期 : 节日/假期/补班，显示标签

• 返回示例

{
    "error_code": 0,
    "description": "success",
    "error_msg": "success",
    "data": {
        "2025-09-28": "班",
        "2025-10-01": "国庆节",
        "2025-10-02": "休",
        "2025-10-03": "休",
        "2025-10-04": "休",
        "2025-10-05": "休",
        "2025-10-06": "中秋节",
        "2025-10-07": "休",
        "2025-10-08": "休",
        "2025-10-11": "班"
    }
}