节假日查询

支持从2007年开始到现在的节假日数据，支持按年查，按天查，按日期范围查，批量查

API地址

接口地址：GET https://api.youngwang1228.com:48000/holiday?type={type}&param={param}
价格：免费
频率：60 次/分钟

Query参数

参数	类型	必填	说明
type	string	是	查询类型，`day`：日期，`year`：年份，`range`：日期范围
param	string	是	日期值。 `type=day`时：传日期值，多个值逗号隔开，如：2024-05-01,2024-05-02 `type=range`时：传日期范围，如：2024-05-01,2024-05-02 `type=year`时：传年份，如：2024

请求示例

日期

https://api.youngwang1228.com:48000/holiday?type=day&param=2024-05-01

日期批量

https://api.youngwang1228.com:48000/holiday?type=day&param=2024-04-20,2024-05-01,2024-05-02

日期范围

https://api.youngwang1228.com:48000/holiday?type=range&param=2024-04-20,2024-05-02

年份

https://api.youngwang1228.com:48000/holiday?type=year&param=2010

响应结果

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "name": "工作日",
            "date": "2024-04-20",
            "isOffDay": false
        },
        {
            "name": "劳动节",
            "date": "2024-05-01",
            "isOffDay": true
        },
        {
            "name": "劳动节",
            "date": "2024-05-02",
            "isOffDay": true
        }
    ]
}

参数	类型	说明
code	int	状态码
msg	string	状态信息
data	object \| array	单日期查询返回object，其他返回array
name	string	节假日名称
date	string	日期
isOffDay	boolean	是否为休息日，如节假日补班的周末会返回false

认证

右上角使用 Github 或 gitee 快速登录，登录后可以获取 AccessToken

在请求头增加 Authorization: AccessToken 即可调用API

"Header":{
     "Authorization":"您的AccessToken",
}

Authorization

状态码

响应码	说明
200	成功
404	接口不存在
10000	参数错误
10001	无效的Token
10002	Token已过期
10003	接口维护
10004	接口已下线
10005	接口暂未实现
10006	账号使用太频繁啦
10007	API调用太频繁啦
10008	被禁止的IP
10009	请求方法不支持
10999	系统内部异常

关于本站

本人从事开发10余年，在自己的项目中积攒了大量技术组件，恰好手上有空闲服务器，准备将技术组件API化，并免费提供给有需要的人。

本站API都是由本人利用业余时间开发和维护的，欢迎大家使用，如果发现bug或者有更好的建议，欢迎联系。

注意事项

由于带宽和计算资源有限，每个API都将会限制调用频率，具体限制视计算复杂度而定，一般都可以满足正常使用
为避免恶意攻击，每个账号都将限制调用频率，正常使用一般不会被误伤
我会及时维护本站API，确保数据得到更新。同时会持续开发新的接口，丰富服务内容
如果有API需求也可直接联系我，通用且在我能力范围内的，将尽快安排
生产使用请预估你的业务量，如果可预见将超出频率限制，建议可增加队列缓冲
本站API永久免费

联系方式

youngwang1228@gmail.com

鼓励一下

如果你觉得本站对您有帮助，不妨请作者喝杯咖啡。