节日/节气 API 服务

GET请求自动识别当日节气/节日，302重定向对应图片，支持自定义图床、图片格式、月份图、南北小年区分与调试输出

快速开始

图片标签直接引用（默认跳转节气/节日图片）：

<img src="https://cdn.foxurl.cn/festival" alt="今日节日" style="width:100%; height:auto; max-width:100%; display:block;">

默认返回 302 重定向到对应的节日/节气图片资源。

节日/节气示例预览

请求方式：GET | 请求地址：https://cdn.foxurl.cn/festival

参数	类型	必填	默认值	说明
`url`	string	否	https://img.foxurl.cn/	自定义图床根域名，支持http/https，自动补全协议与斜杠
`type`	string	否	空字符串	填month强制读取当月月份图，空值自动使用节日/节气图
`num`	int/string	否	随机1/2	指定图片序号，仅支持 1、2
`imgtype`	string	否	png	图片后缀，支持：png/jpg/jpeg/gif/bmp/webp
`region`	string	否	s	小年区分：n=北方小年，s=南方小年
`debug`	string/int	否	关闭	传1开启调试，输出日期、农历、节日、节气、图片链接
`y/m/d/h/i`	int	否	当前系统时间	调试专用，指定年/月/日/时/分，仅debug=1时生效

参数说明：

未携带debug参数，接口返回302状态码，自动重定向至拼接后的图片地址

HTTP/1.1 302 Found
Location: https://img.foxurl.cn/夏至1.png

开启调试后，返回200状态码，明文输出完整信息，包含：公历日期、星期、农历、节日、节气、图片地址

今天是：2025年6月21日 星期六 农历：乙巳年五月初一日
今天的节日是：夏至
今天的节气是：夏至
图片跳转地址：https://img.foxurl.cn/夏至1.png

# 自动识别当日节日/节气，默认图床+png格式
https://cdn.foxurl.cn/festival

https://cdn.foxurl.cn/festival?url=https://img.example.com

# 强制返回当前月份图片，忽略节日节气
https://cdn.foxurl.cn/festival?url=img.foxurl.cn&type=month

# 指定序号2，webp格式
https://cdn.foxurl.cn/festival?num=2&imgtype=webp

# 小年当天使用北方小年图片
https://cdn.foxurl.cn/festival?region=n

# 开启调试，输出所有信息
https://cdn.foxurl.cn/festival?debug=1

# 调试+指定日期测试
https://cdn.foxurl.cn/festival?debug=1&y=2025&m=1&d=1

https://cdn.foxurl.cn/festival?url=img.foxurl.cn&type=&num=1&imgtype=jpg®ion=s&debug=0

自建静态站点/对象存储/图床存放素材，支持后缀：png、jpg、jpeg、gif、bmp、webp，默认png

图床根目录新建 month 文件夹，文件命名：m_月份数字+序号.后缀

#示例
m_011.png  → 1月第一张
m_012.png  → 1月第二张
m_121.png  → 12月第一张
m_122.webp → 12月第二张webp格式

节日图片直接放置在图床根目录，命名：节日名称+序号.后缀

#示例
夏至1.png
夏至2.jpg
中秋节1.webp
春节2.png
小年N1.png
小年S2.png

重要注意：

春节、元宵节、二月二、端午节、七夕节、中秋节、重阳节、腊八、小年N、小年S、除夕

元旦、劳动节、青年节、教师节、九一八、国庆节、母亲节、父亲节

立春、雨水、惊蛰、春分、清明、谷雨、立夏、小满、芒种、夏至、小暑、大暑、立秋、处暑、白露、秋分、寒露、霜降、立冬、小雪、大雪、冬至、小寒、大寒