国家法定节日放假安排查询API

接口描述

国家法定节日放假安排查询API， 通过指定年[例如：2024]获取假期安排及补班情况。假期是指国家法定的假日，也指单位规定的休假日。除双休日外，我国国定假期为元旦、春节、清明、劳动节、端午、中秋、国庆。

GET https://www.idcd.com/api/holiday

输入参数

以下请求参数列表仅列出了接口请求参数，不包含公共参数，完整公共参数列表见 公共请求参数。

参数名称 类型 必选 描述
year Int 是 年份，例如：2024

输出参数

参数名称 类型 必选 描述
year Int 是 年份
festival String 是 节日名称
start_time String 是 假期开始日期
end_time String 是 假期结束日期
days Int 是 假期天数
weekday String 是 调休日期，多个逗号分隔，无内容说明不调休。

示例

  1. 输入示例
curl --location --request GET 'https://www.idcd.com/api/holiday?year=2024' \
--header 'ClientID: df77f2de-2924-4499-adda-1c4cc243625a' \
--header 'Nonce: v0j38hHHUEqFwoh0Gc8Rbfi737xtIpLL' \
--header 'Timestamp: 1716085926' \
--header 'Signature: 5b1230f42bad2ffd5ad09890a8ebb47c02d74668be0cf7bb54a0f6a14996117b' \
--header 'SignatureMethod: HmacSHA256'
  1. 输出示例
{
    "status": true,
    "message": "Success",
    "request_id": "eb33e11b-52bd-4cbd-9c95-a28645d7c16e",
    "data": [
        {
            "year": 2024,
            "festival": "元旦节",
            "start_time": "2023-12-30",
            "end_time": "2024-01-01",
            "days": 3,
            "weekday": ""
        },
        {
            "year": 2024,
            "festival": "春节",
            "start_time": "2024-02-10",
            "end_time": "2024-02-17",
            "days": 8,
            "weekday": "2024-02-04,2024-02-18"
        },
        {
            "year": 2024,
            "festival": "清明节",
            "start_time": "2024-04-04",
            "end_time": "2024-04-06",
            "days": 3,
            "weekday": "2024-04-07"
        },
        {
            "year": 2024,
            "festival": "劳动节",
            "start_time": "2024-05-01",
            "end_time": "2024-05-05",
            "days": 5,
            "weekday": "2024-04-28,2024-05-11"
        },
        {
            "year": 2024,
            "festival": "端午节",
            "start_time": "2024-06-08",
            "end_time": "2024-06-10",
            "days": 3,
            "weekday": ""
        },
        {
            "year": 2024,
            "festival": "中秋节",
            "start_time": "2024-09-15",
            "end_time": "2024-09-17",
            "days": 3,
            "weekday": "2024-09-14"
        },
        {
            "year": 2024,
            "festival": "国庆节",
            "start_time": "2024-10-01",
            "end_time": "2024-10-07",
            "days": 8,
            "weekday": "2024-09-29,2024-10-12"
        }
    ]
}