logo logo
公告

使用须知

  • 1、禁止任何违反国家法律、法规的站点调用本站接口。
  • 2、建议在调用本站API时,使用本地缓存 + 兜底逻辑,才是必须的最佳实践,既能避免高频调用触发本站限流,也能在网站临时不可用时保障业务正常运行。
  • 3、这是用业余时间开发的基于ThinkPHP 8的中国法定节假日API,免费提供给需要的个人开发者。
  • 4、节假日信息会尽快更新,如发现某个节假日配置错误或没有配置,请工单反馈(首选)或联系QQ、邮件反馈。
  • 5、系统会对异常频率请求、无效高并发调用、恶意刷接口等行为进行监控,自然日内429返回超300进行24小时封禁,暂未设定永久封禁策略,但恶意请求访问的 IP,将被永久封禁。
  • 6、已永久封禁IPv4列表:210.21.237.170,14.212.104.70,39.150.193.166,1.192.178.202
  • 7、已永久封禁IPv6列表:240e:306:32c5:7101:c5b2:63fd:2453:42f1

联系方式

  • QQ:66257875
  • 邮箱:Jack.Liu@ailcc.com (PS:邮箱联系更快)

近期更新 -- 用户控制台功能更新 2026-11-17 17:10:21

  • 1、新增循环日历模块:循环日程单独展示,与单次日程分开管理。
  • 2、循环日程编辑/删除时可选「仅本次」或「本次及以后」,弹窗显示日程内容,避免选错。
  • 3、被取消的循环日程支持恢复和彻底删除。
  • 4、「清空当天」只影响当天,不再影响循环日程的其它日期。
  • 5、窄窗口下页面布局优化,显示更美观。
  • 6、修复月末循环日程编辑时后续日程丢失的问题。
  • 7、修复功能检查中发现的多个问题:接口报错、路由缺失、周视图参数异常等。
  • 8、修复日历订阅输出中已取消日程仍显示的问题。
  • 9、安全加固:所有操作严格限定本人数据,输入全面校验,清理冗余代码与文件。

常见问题

  • 1、api 接口不支持HTTP调用,必须是HTTPS。
  • 2、网站使用白名单加访问IP进行访问限制,域名、IP未在白名单中的,接口每分钟仅允许查询31次,24小时最多可查询10000次(所有接口的总计查询次数)。
  • 3、注册白名单用户或更高级用户,拥有更多的访问次数。
  • 4、白名单必须配合Token使用,支持 Header Token、URL Token 使用,建议选用 Header Token。
  • URL/xxx?token=xxx
    HEADER: X-API-TOKEN: xxx
  • 5、部分接口采用缓存机制,以减轻连续请求对服务器和数据库的压力。缓存以数据版本号为基准,当缓存版本号与当前版本号不一致时,服务器会自动查询最新的日历数据并更新缓存,各接口的缓存时长见下方接口文档中的“缓存说明”。
  • 6、超过接口限额会返回 429 错误;当日 429 错误累计超过阈值后,IP 将被自动封禁 24 小时并返回 423 错误,响应中会告知当前累计封禁次数。
  • 7、接口返回的农历干支年与生肖以正月初一(春节)为分界,符合国家标准 GB/T 33661-2017,非立春分界。
  • 8、API 返回的 JSON 字段名严格区分大小写(如 cnAnimal),调用方拼写不一致会导致取值为空。
  • 9、法定节假日数据随国务院通知更新,未来年度若尚未发布官方安排,对应日历内容为空属正常现象。

限额说明及规则

  • 1、限额都是按照每个用户的域名或IP统计的,免费注册用户最多允许1个域名/IP。
  • 2、免费用户所有接口限额时间为 24 小时,每天凌晨00:01重置状态。
  • 3、免费用户节假日 API 接口24小时内总计限额为 10000次/IP,每分钟限制31次。

API接口说明文档

当前数据版本:V80 接口返回的 version 字段即为此值,若与你调用的版本不一致,说明数据已更新或调用方存在缓存。

苹果设备订阅法定节假日 - ICS

苹果官方已有中国法定节假日订阅,非必要不建议订阅本站日历,因为本站日历中包含24节气、其它节气及民俗节日等信息。


  • 接口地址: GET https://holiday.ailcc.com/api/holiday/ics
  • 接口功能:返回一个可供苹果日历、Google 日历、Outlook 等日历软件订阅的 ICS(iCalendar)日历文件,其中包含 “法定节假日、调休放假、补班” 的日期信息。
  • 使用办法:该接口不需要任何参数,直接在设备上的日历中 订阅 即可。
  • 日历说明:服务器会自动返回“前两年 + 当前年份 + 后两年”的节假日 ICS 内容,只更新近5年的日历,法定节假日随国务院通知更新。 例如当前年份为 2026 年,则日历范围为 2024-01-01 至 2028-12-31,若最后一年无节假日或日历内容,通常表示该年度官方数据尚未发布或站长尚未维护。
  • 缓存说明: 该接口缓存时长 1 小时。
  • 接口包含:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//AILCC//Chinese Holiday API//CN
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-APPLE-CALENDAR-COLOR:#FF3333
X-WR-CALNAME:中国法定节假日

BEGIN:VEVENT
UID:0da98bb11fe3f47c6b25c43014668bb6@ailcc.com
DTSTART;VALUE=DATE:20250101
DTEND;VALUE=DATE:20250101
SUMMARY:元旦(休)
DESCRIPTION:元旦(休)
END:VEVENT

BEGIN:VEVENT
UID:395865170ccabb58554e436e264fd40b@ailcc.com
DTSTART;VALUE=DATE:20250201
DTEND;VALUE=DATE:20250201
SUMMARY:春节(休)
DESCRIPTION:春节(休)
END:VEVENT

END:VCALENDAR

📱 订阅方式:


  • iPhone / iPad:打开“日历”app,点屏幕下方中间的“日历”,再点左下角“添加日历”,选择“添加订阅日历”,粘贴URL,点订阅。
  • Mac:日历 → 文件 → 新建日历订阅 → 输入地址。

点击跳转《iPhone如何设置节假日自动闹钟》

苹果设备订阅个人日历信息 - user_ics

个人日历功能因考虑到垃圾日历、广告网址等问题,停止注册使用,后续只允许邀请用户及付费用户使用。也只可以只订阅本站默认的万年历,该订阅无需注册即可订阅。


  • 接口地址: GET https://holiday.ailcc.com/api/holiday/user_ics/token
  • 接口功能:返回一个可供苹果日历、Google 日历、Outlook 等日历软件订阅的 ICS(iCalendar)日历文件,其中包含 “用户自己创建的日历事项” 等信息。
  • 使用办法:该接口不需要任何参数,直接在设备上的日历中 订阅 即可。
  • 日历说明:服务器会自动返回“前两年 + 当前年份 + 后两年”的节假日 ICS 内容,只更新近5年的日历。 例如当前年份为 2026 年,则日历范围为 2024-01-01 至 2028-12-31。
  • 缓存说明: 该接口缓存时长 1 小时。
  • 接口包含:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//AILCC//User Calendar//CN
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:我的日历
X-WR-TIMEZONE:Asia/Shanghai
BEGIN:VTIMEZONE
TZID:Asia/Shanghai
BEGIN:STANDARD
TZOFFSETFROM:+0800
TZOFFSETTO:+0800
TZNAME:CST
DTSTART:19700101T000000
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
UID:be5fdab43f144d93eaae1f20230bcb2b@ailcc.com
DTSTART;VALUE=DATE:20250416
DTEND;VALUE=DATE:20250417
SUMMARY:买一张手机卡
DESCRIPTION:买一张手机卡
END:VEVENT
BEGIN:VEVENT
UID:5a6b50d59dac29741cd6d23e39aced4a@ailcc.com
DTSTART;VALUE=DATE:20250421
DTEND;VALUE=DATE:20250422
SUMMARY:XXXXXXXXXX
DESCRIPTION:XXXXXXXXXX
END:VEVENT

END:VCALENDAR

📱 订阅方式:


  • iPhone / iPad:打开“日历”app,点屏幕下方中间的“日历”,再点左下角“添加日历”,选择“添加订阅日历”,粘贴URL,点订阅。
  • Mac:日历 → 文件 → 新建日历订阅 → 输入地址。

获取指定日期的节假日信息 - info

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/info/$date
  • @params $date: 指定日期的字符串,格式 ‘2025-10-01’。可以省略,则默认服务器的当前时间。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json: 如果不是节假日或周末,holiday字段为null。
  • 缓存说明: 该接口缓存时长 24 小时。
{
  "code": 0, // 0服务正常。-1服务出错
  "version": 1, // 版本号
  "type": { 
    "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
    "name": "国庆节(休)", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
    "week": 3, // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
    "cnLunar": "八月初十", // 农历
    "extra_info": "国庆节", // 其它节气
    "cnLunarYear": "", // 农历干支年
    "cnAnimal": "", // 生肖
    "name_en": "National Day of China", // name字段的节假日英文名称
    "extra_en": "National Day of China" // extra_info字段的节假日英文名称
  },
  "holiday": {
    "holiday": true, // true表示是节假日,false表示是调休。
    "name": "国庆节(休)", // 节假日的中文名。如果是调休,则是调休的中文名,例如“国庆节(休)”。
    "wage": 3, // 薪资倍数,1表示是1倍工资,该数据不再详细维护。
    "date": "2025-10-01", // 查询的时间参数。
    "after": null, // 只在调休或补班下有该字段。1表示假后调休或补班,0表示假前调休或补班,否则为null。
    "target": "国庆节", // 只在调休下有该字段。表示调休的节假日,否则为null。
    "rest": 39, // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China" // name字段的节假日英文名称
  }
}

示例:


  • https://holiday.ailcc.com/api/holiday/info/2025-10-1
  • https://holiday.ailcc.com/api/holiday/info/2025-10-01
  • https://holiday.ailcc.com/api/holiday/info/2025-10-01?lang=en

批量查询指定日期节假日信息 - batch

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/batch?d=$date&type=Y
  • @params d: 指定日期的字符串,多个日期之间使用且只能使用英文逗号“,”连接。最大长度查询个数31,多余日期不返回,格式 ‘2025-10-01’。
  • @params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json: 返回以日期为key的对象。
  • 缓存说明: 该接口缓存时长 24 小时。
{
  "code": 0, // 0服务正常。-1服务出错
  "version": 1, // 版本号
  "holiday": { // 传过来的日期是什么,key就是什么。传多少个就有多少个。
    "2025-09-9": null, // 如果不是节假日,则为null
    "2025-10-08": { // holiday的值都是一致的
      "holiday": true, // true表示是节假日,false表示是调休。
      "name": "国庆节(休)", // 节假日的中文名。如果是调休,则是调休的中文名,例如“国庆节(休)”。
      "wage": 1, // 薪资倍数,1表示是1倍工资,该数据不再详细维护。
      "date": "2025-10-08", // 查询的时间参数。
      "rest": 1, // 表示当前时间距离目标还有多少天。
      "name_en": "National Day of China" // name字段的英文名称
    }
  },
  "type": { // 只有明确指定参数 type=Y 时才返回类型信息
    "2025-09-9": { // 一一对应holiday对象的key,holiday有多少个这里就有多少个
      "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
      "name": "周二", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
      "week": 1, // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
      "cnLunar": "七月十八", // 农历
      "extra_info": "", // 其它节气,一般为空
      "cnLunarYear": "", // 农历干支年
      "cnAnimal": "", // 生肖
      "name_en": "Tuesday" // name字段的英文名称
    },
    "2025-10-08": {
      "type": 2,
      "name": "国庆节(休)",
      "week": 3
      "cnLunar": "八月十七",
      "extra_info": "寒露",
      "cnLunarYear": "",
      "cnAnimal": "",
      "name_en": "National Day of China", // name字段的英文名称
      "extra_en": "Cold Dew" // extra_info字段的英文名称
    }
  }
}

示例:


  • https://holiday.ailcc.com/api/holiday/batch?d=2025-9-9
  • https://holiday.ailcc.com/api/holiday/batch?d=2025-9-9,2025-10-08,2025-03-1&type=Y
  • https://holiday.ailcc.com/api/holiday/batch?d=2025-9-9,2025-10-08,2025-03-1&type=Y&lang=en

获取指定日期的下一个节假日(如果在放假前有调休,也会返回)- next

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/next/$date?type=Y&week=Y
  • @params $date: 指定日期的字符串,格式“2025-09-27”,日期可以省略,则默认服务器的当前时间。
  • @params type: 是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
  • @params week: 节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json: 返回指定日期的下一个最近的节假日,如果在放假之前要调休,则会一起返回调休的信息。如果包含周末,则节日和周末冲突时,以节日为优先级。 比如特殊情况:周六是调休,则holiday返回周日,workday返回周六。其它情况以此类推,holiday永远会返回下一个节日。
  • 缓存说明: 该接口缓存时长 1 小时。
{
  "code": 0, // 0服务正常。-1服务出错。
  "version": 1, // 版本号
  "holiday": {
    "holiday": true, // 该字段一定为true。
    "name": "国庆节(休)", // 节假日的中文名。
    "wage": 3, // 薪资倍数,3表示是3倍工资,该数据不再详细维护。
    "date": "2025-10-01", // 节假日的日期。
    "cnLunar": "八月初十", // 农历。
    "cnLunarYear": "", // 农历干支年
    "cnAnimal": "", // 生肖
    "rest": 4, // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China" // name字段的英文名称
  },
  "workday": { // 如果节假日前没调休,则此字段为null。
    "holiday": false, // 此字段一定为false。
    "name": "国庆节(班)", // 调休的中文名。
    "after": null, // 只在调休或补班下有该字段,1表示假后调休或补班,0表示假前调休或补班,否则为null。
    "wage": 1, // 薪资倍数,3表示是3倍工资,该字段不在详细维护。
    "target": "国庆节", // 表示调休的节假日。
    "date": "2025-09-28", // 表示要调休的日期。
    "rest": 1, // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China" // name字段的英文名称
  },
  "type": { // 只有明确指定参数 type=Y 时才返回类型信息。
    "holiday": { // 对应 holiday 中的日期类型,只有返回 holiday 信息时才存在此日期类型。
      "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节(休)", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
      "week": enum(1 - 7), // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
      "cnLunar": "八月初十", // 农历
      "cnLunarYear": "", // 农历干支年
      "cnAnimal": "", // 生肖
      "extra_info": "", // 其它节气,一般为空
      "date": "2025-10-01", // 当天时间
      "name_en": "National Day of China" // name字段的英文名称
    },
    "workday": { // 对应 workday 中的日期类型,只有返回 workday 信息时才存在此日期类型
      "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节(班)", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
      "week": 7 // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
      "cnLunar": "八月初七", // 农历
      "extra_info": "", // 其它节气,一般为空
      "date": "2025-09-28", // 当天时间
      "name_en": "National Day of China" // name字段的英文名称
    }
  }
}

示例:


  • https://holiday.ailcc.com/api/holiday/next/
  • https://holiday.ailcc.com/api/holiday/next/2025-9-9
  • https://holiday.ailcc.com/api/holiday/next/2025-09-27?type=Y&week=Y
  • https://holiday.ailcc.com/api/holiday/next/2025-09-27?type=Y&week=Y&lang=en

获取指定日期的下一个工作日(工作日包含正常工作日、调休)不包含当天 - nextWorkday

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/nextWorkday/$date
  • @params $data:指定日期的字符串,格式“2025-10-01”,时间可以省略,则默认服务器的当前时间。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json:返回指定日期的下一个最近的工作日,工作日包含正常工作日、调休,不包含当天。
  • 缓存说明: 该接口缓存时长 1 小时。
{
  "code": 0, // 0服务正常。-1服务出错
  "version": 1, // 版本号
  "workday": { // 如果没有查找到最近的工作日,则此字段为null。最大查找长度为30
    "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
    "name": "工作日", // 工作日类型中文名,可能值为 周一 至 周五、某某调休。
    "week": 4, // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
    "date": "2025-10-09", // 表示要工作的日期。
    "rest": 8, // 表示当前时间距离目标还有多少天。
    "cnLunarYear": "", // 农历干支年
    "cnAnimal": "", // 生肖
    "extra_info": "", // 其它节气,一般为空
    "name_en": "Thursday" // name字段英文名称
  }
}

示例:


  • https://holiday.ailcc.com/api/holiday/nextWorkday/
  • https://holiday.ailcc.com/api/holiday/nextWorkday/2025-10-1
  • https://holiday.ailcc.com/api/holiday/nextWorkday/2025-10-01
  • https://holiday.ailcc.com/api/holiday/nextWorkday/2025-10-01?lang=en

获取指定年份或年月份的所有节假日信息 - year

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/year/$date
  • @params $date:指定年份或年月份,格式“2025-10”,“2025-9” 或者“2025”。可以省略,则默认服务器当前时间的年份。
  • @params type:是否返回日期类型,默认不返回。可选值:’Y’ 返回,’N’ 不返回。
  • @params week:节假日是否包含周末,默认不包含。可选值:’Y’ 包含周末,’N’ 不包含。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json:返回指定年份或年月份的所有节假日,以日期作为key,格式:mm-dd。如果没有该年份或月份,则返回空对象,只返回节假日,不返回任何补班。
  • 缓存说明: 该接口缓存时长 24 小时。
{
  "code": 0, // 0服务正常。-1服务出错
  "version": 1, // 版本号
  "holiday": {
    "10-01": {
      "holiday": true, // 该字段一定为true
      "name": "国庆节(休)", // 节假日的中文名。
      "wage": 3, // 薪资倍数,3表示是3倍工资,该数据不再详细维护。
      "date": "2025-10-01", // 节假日的日期
      "cnLunar": "八月初十", // 农历
      "cnLunarYear": "", // 农历干支年
      "cnAnimal": "", // 生肖
      "extra_info": "国庆节", // 其它节气,一般为空
      "rest": 39, // 表示当前时间距离目标还有多少天。
      "name_en": "National Day of China", // name字段英文名称
      "extra_en": "National Day of China" // extra_info字段英文名称
    },
    "10-02": {
      "holiday": true,
      "name": "国庆节(休)",
      "wage": 3,
      "date": "2025-10-02",
      "cnLunar": "八月十一",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "",
      "rest": 40,
      "name_en": "National Day of China"
    }
  }
  "type": { // 只有明确指定参数 type=Y 时才返回类型信息
    "2025-10-01": { // 一一对应holiday对象的key,holiday有多少个这里就有多少个
      "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节(休)", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
      "week": enum(1 - 7), // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
      "cnLunar": "八月初十", // 农历
      "cnLunarYear": "", // 农历干支年
      "cnAnimal": "", // 生肖
      "extra_info": "国庆节", // 其它节气,一般为空
      "name_en": "National Day of China", // name字段英文名称
      "extra_en": "National Day of China" // extra_info字段英文名称
    },
    "2025-10-02": {
      "type": 2,
      "name": "国庆节(休)",
      "week": 4
      "cnLunar": "八月十一",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "",
      "name_en": "National Day of China"
    },
    "2025-10-03": {
      "type": 2,
      "name": "国庆节(休)",
      "week": 5
      "cnLunar": "八月十二",
      "cnLunarYear": "",
      "cnAnimal": "", 
      "extra_info": "",
      "name_en": "National Day of China"
    },
  }
}

示例:


  • https://holiday.ailcc.com/api/holiday/year/
  • https://holiday.ailcc.com/api/holiday/year/2025
  • https://holiday.ailcc.com/api/holiday/year/2025-10?type=Y&week=Y
  • https://holiday.ailcc.com/api/holiday/year/2025-10?type=Y&week=Y&lang=en

获取指定年份里每天的信息 - allyear

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/allyear/$date
  • @params $date:指定年份2026”,可以省略,则默认服务器当前时间的年份。
  • @params lang: 是否返回节假日的英文名称,默认不返回。可选值:’en’ 返回。
  • @return json:返回指定年份全年每天的信息,以日期作为key,格式:mm,如果没有该年份或月份,则返回当年。
  • 缓存说明: 该接口缓存时长 24 小时。
{
  "code": 0, // 返回码,0服务正常。-1服务出错
  "version": 1, // 版本号
  "year": "2026", // 查询的年份(YYYY)
  "count": 365, // 当年天数(平年 365,闰年 366)
  "data": [
    {
      "date": "2026-01-01", // 日期(YYYY-MM-DD)
      "type": enum(0, 1, 2, 3,4), // 节假日类型,分别表示 工作日、周末、节日、调休放假、补班。
      "is_holiday": 1, // 是否为休息日,1 = 放假(周末 / 法定节假日 / 调休),0 = 工作日(含补班)
      "name": "元旦节(休)", // 节假日的中文名。如果是调休,则是调休的中文名,例如“国庆节(休)”。
      "wage": 1, // 薪资倍数,3表示是3倍工资,该数据不再详细维护。
      "after": null, // 只在调休或补班下有该字段。1表示假后调休或补班,0表示假前调休或补班,否则为null。
      "week": 4, // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
      "target": "元旦节", // 只在调休下有该字段。表示调休的节假日,否则为null。
      "lunar": "冬月十三", // 农历
      "cnLunarYear": "", // 农历干支年
      "cnAnimal": "", // 生肖
      "extra_info": "元旦节", // 其它节气,一般为空
      "name_en": "New Year's Day", // name字段英文名称
      "extra_en": "New Year's Day" // extra_info字段英文名称
    },
    {
      "date": "2026-01-02",
      "type": 2,
      "is_holiday": 1,
      "name": "元旦节(休)",
      "wage": 1,
      "after": null,
      "week": 5,
      "target": "元旦节",
      "lunar": "冬月十四",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-03",
      "type": 2,
      "is_holiday": 1,
      "name": "元旦节(休)",
      "wage": 1,
      "after": null,
      "week": 6,
      "target": "元旦节",
      "lunar": "冬月十五",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-04",
      "type": 4,
      "is_holiday": 0,
      "name": "元旦节(班)",
      "wage": 1,
      "after": 1,
      "week": 7,
      "target": "元旦节",
      "lunar": "冬月十六",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-05",
      "type": 0,
      "is_holiday": 0,
      "name": "周一",
      "wage": 1,
      "after": null,
      "week": 1,
      "target": "",
      "lunar": "冬月十七",
      "cnLunarYear": "",
      "cnAnimal": "",
      "extra_info": "小寒",
      "name_en": "Monday",
      "extra_en": "Lesser Cold"
    },
  ]
}

示例:


  • https://holiday.ailcc.com/api/holiday/allyear/
  • https://holiday.ailcc.com/api/holiday/allyear/2026
  • https://holiday.ailcc.com/api/holiday/allyear/2026?lang=en

获取个人日历中今天的日历事项 - user_today

特别声明:此接口适用于站长开发版的ESP32 桌面墨水屏日历摆件的烧录固件,当然其它地方也可以用,该接口仅返回当天的个人日历事项,与ics及user_ics接口完全不同。
需要注意的是:ESP32无法使用本站的ics或user_ics接口。
在站长开发的固件中,法定节假日、节气、万年历、农历等信息不在此接口查询。

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/user_today/token
  • @params token:注册用户才有token,不支持查询其它日期日历事项,仅返回当天日历事项。
  • @return json:返回当天的个人日历事项。
  • 缓存说明: 该接口暂未开启缓存设置。
{
  "code": 0, // 返回码,0服务正常。-1服务出错
  "version": 1, // 版本号
  "date": "2026-08-07", // 当天日期时间
  "items": [ // 当天个人日历事项
   {
      "title": "循环日历-事项内容或标题", // 日历事项标题
      "value": "循环日历--事项内容", // 日历事项内容
      "all_day": 1, // 是否全天日历事项:1为全天,0为定时事项,为0时必须有开始和结束时间。
      "start_time": null, // 日历事项开始时间
      "end_time": null, // 日历事项结束时间
      "alarm": 0 // 事件提醒提前量,对该接口没有直接作用
    },
    {
      "title": "1-事项内容或标题",
      "value": "1-事项内容",
      "all_day": 1,
      "start_time": null,
      "end_time": null,
      "alarm": 0
    },
    {
      "title": "2-事项内容或标题",
      "value": "2-事项内容",
      "all_day": 1,
      "start_time": null,
      "end_time": null,
      "alarm": 0
    },
    {
      "title": "3-事项内容或标题",
      "value": "3-事项内容或标题",
      "all_day": 0,
      "start_time": "10:00",
      "end_time": "10:30",
      "alarm": 0
    }

示例:


  • https://holiday.ailcc.com/api/holiday/user_today/token

高级API,适用于语音交互等 - tts

声明:此接口适用语音交互、AI机器人沟通、DIY日历显示等,但并不限制使用场景,可自由发挥。

  • 接口地址:GET https://holiday.ailcc.com/api/holiday/tts/
  • @params :不需要任何参数,也不支持参数。
  • @return json:返回可直接阅读、显示、播放的文字,仅支持查询当天。
  • 缓存说明: 该接口缓存时长 24 小时。
{
  "code": 0, // 返回码,0服务正常。-1服务出错
  "tts": "再坚持一天,明天就周末了,加油!"
}

示例:


  • https://holiday.ailcc.com/api/holiday/tts/

赞助记录

赞助时间 赞助名称 赞助金额(元) 赞助方式 赞助备注
2026-11-06 09:51:46 *o ¥5.00 微信
2026-10-12 15:26:38 *山 ¥2.00 微信
2026-09-21 09:57:50 *— ¥1.00 微信
2026-08-07 15:58:32 *G ¥3.00 微信 想拥有一个注册账号的名额(请联系站长邮箱)
2026-08-06 10:06:34 *飞 ¥1.00 微信
2026-07-23 22:11:34 *正 ¥3.00 微信
2026-07-18 20:45:13 ***年 ¥1.00 微信
2026-07-12 17:31:44 *风 ¥5.00 微信 感谢兄弟为爱发电,小小的支持不成敬意
2026-04-12 15:53:00 ***东 ¥3.00 支付宝
2026-03-23 15:28:38 ***k ¥1.00 微信
2026-02-25 22:55:27 **林 ¥0.50 支付宝
2026-02-02 10:32:11 ***爱 ¥1.00 微信
2026-01-22 09:19:01 *哦 ¥3.00 微信