【API】节假日信息接口

1. 获取当年的节假日信息

GET https://api.996.ninja/holiday/info

---

请求参数

无需参数

---

响应字段说明

字段	类型	说明
status	number	HTTP 状态码
message	string	返回信息，如 "Success"
data	object	数据体，包含节假日信息
data.year	number	年份
data.papers	array	相关政策文件链接
data.days	array	节假日详细信息数组
data.days[].name	string	节假日名称
data.days[].date	string	日期 (YYYY-MM-DD格式)
data.days[].isOffDay	boolean	是否为休息日 (true=休息, false=调休上班)
timestamp	string	返回时间戳

---

示例请求

GET /holiday/info HTTP/1.1
Host: api.996.ninja

示例响应

{
  "status": 200,
  "message": "Success",
  "data": {
    "year": 2025,
    "papers": [
      "https://www.gov.cn/zhengce/zhengceku/202411/content_6986383.htm"
    ],
    "days": [
      {
        "name": "元旦",
        "date": "2025-01-01",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-01-26",
        "isOffDay": false
      },
      {
        "name": "春节",
        "date": "2025-01-28",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-01-29",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-01-30",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-01-31",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-02-01",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-02-02",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-02-03",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-02-04",
        "isOffDay": true
      },
      {
        "name": "春节",
        "date": "2025-02-08",
        "isOffDay": false
      },
      {
        "name": "清明节",
        "date": "2025-04-04",
        "isOffDay": true
      },
      {
        "name": "清明节",
        "date": "2025-04-05",
        "isOffDay": true
      },
      {
        "name": "清明节",
        "date": "2025-04-06",
        "isOffDay": true
      },
      {
        "name": "劳动节",
        "date": "2025-04-27",
        "isOffDay": false
      },
      {
        "name": "劳动节",
        "date": "2025-05-01",
        "isOffDay": true
      },
      {
        "name": "劳动节",
        "date": "2025-05-02",
        "isOffDay": true
      },
      {
        "name": "劳动节",
        "date": "2025-05-03",
        "isOffDay": true
      },
      {
        "name": "劳动节",
        "date": "2025-05-04",
        "isOffDay": true
      },
      {
        "name": "劳动节",
        "date": "2025-05-05",
        "isOffDay": true
      },
      {
        "name": "端午节",
        "date": "2025-05-31",
        "isOffDay": true
      },
      {
        "name": "端午节",
        "date": "2025-06-01",
        "isOffDay": true
      },
      {
        "name": "端午节",
        "date": "2025-06-02",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-09-28",
        "isOffDay": false
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-01",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-02",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-03",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-04",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-05",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-06",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-07",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-08",
        "isOffDay": true
      },
      {
        "name": "国庆节、中秋节",
        "date": "2025-10-11",
        "isOffDay": false
      }
    ]
  },
  "timestamp": "2025-09-20T10:26:02.627878"
}

节假日信息 API 实时体验