查询节假日信息,接口返回节日名称类型、农历信息、上班调休,假期范围、拼假建议、及工作日相关信息等。通过请求参数mode还可以指定是否返回当天有关的国内外节日信息。参考文章:节假日接口增加多种查询方式
接口支持按年、按月、按日期范围和多个日期批量查询。如按年查询(type=1&date=2020)、按月查询(type=2&date=2020-10)、按日期范围查询(type=3&date=2020-11-1~2020-11-10)、按多个日期批量查询(date=2020-10-1,2020-11-12)
请注意,按年查询只返回中国官方节假日信息;按月查询如未指定末端日期,则默认为从该月第一天到最后一天;按范围查询,起点和终点用波浪号~分隔;按多个日期批量查询用英文半角逗号分隔。无论哪种查询方式,所包含的总日期数不能超过31天。
重点字段:daycode表示日期类型,为0表示工作日、为1节假日、为2双休日、为3调休日(上班),isnotwork表示是否需要上班,为0表示上班,为1表示休息。
提示信息:info字段中的普通节日、双休日和调休日可相互重叠出现(如存在daycode=3的同时info显示双休日);节日指具体某个日期(如2021年1月1号),节假日包含整个假期(如2021年1月1号至3号);节日范围宽泛(如会包含植树节、圣诞节),节假日指来自中国官方发布的有假期的节日,每年底同步更新。
post请求时,enctype应为application/x-www-form-urlencoded
请求参数中有url或特殊字符时,应该对值urlencode编码下
名称 | 类型 | 必填 | 示例值/默认值 | 说明 |
---|---|---|---|---|
key | string | 是 | 您自己的APIKEY(注册账号后获得) | api密钥 |
date | string | 是 | 2021-01-01 | 查询日期或日期范围 |
mode | int | 否 | 0 | 工作模式,为1返回当天全部相关节日信息 |
type | int | 否 | 0 | 查询类型,0批量、1按年、2按月、3范围 |
返回示例作为参考,建议以实际测试结果为准
名称 | 类型 | 示例值 | 说明 |
---|---|---|---|
date | string | 2019-10-01 | 当前阳历日期 |
daycode | int | 1 | 日期类型,为0表示工作日、为1节假日、为2双休日、3为调休日(上班) |
weekday | int | 2 | 星期(数字) |
cnweekday | string | 星期二 | 星期(中文) |
lunaryear | string | 己亥 | 农历年 |
lunarmonth | string | 九月 | 农历月 |
lunarday | string | 初三 | 农历日 |
info | string | 节假日 | 文字提示,工作日、节假日、节日、双休日 |
start | int | 0 | 假期起点计数 |
now | int | 0 | 假期当前计数 |
end | int | 6 | 假期终点计数 |
holiday | string | 10月1日 | 节日日期 |
name | string | 国庆节 | 节假日名称(中文) |
enname | string | National Day | 节日名称(英文) |
isnotwork | int | 1 | 是否需要上班,0为工作日,1为休息日 |
vacation | array | ["2021-01-01","2021-01-02","2021-01-03"] | 节假日数组 |
remark | array | ["2021-12-26","2021-01-08"] | 调休日数组 |
tip | string | 10月1日至7日放假调休,共7天...... | 放假提示 |
rest | string | 10月8日至10月10日请假2天,与周末连休可拼11天长假。 | 拼假建议 |
用户等级 | 免费接口数 | 每日赠送次数 | 会员价格 | 说明 |
---|---|---|---|---|
免费会员 | 15个 | 100次 | 免费 | 每个免费接口每天赠送100次 |
高级会员 | 15个 | 1万次 | 20元/月、120元/年 | 每个免费接口每天赠送1W次 |
黄金会员 | 不限 | 50万次 | 65元/月、390元/年(限时特价) | 每个免费接口每天赠送50W次 |
提示:系统优先使用赠送额度,超出后每次调用消耗1颗天豆(0.0001元),如项目有更高需求请点此升级会员等级。 |
错误消息可能会有所调整,请根据错误代码进行流程判断
错误代码 | 错误消息 | 解释帮助 |
---|---|---|
100 | 内部服务器错误 | 出现此错误码请及时反馈或等待修复 |
110 | 接口暂时维护中 | 接口暂时关闭维护中,请注意相关公告 |
120 | IP请求来源受限 | 设置了IP白名单,来源IP不在白名单内 |
130 | 分钟请求频率超限 | API超出了分钟调用最大频率被暂时限制 |
140 | API没有调用权限 | 请检查接口是否被自行停用或被官方禁用 |
150 | 接口可用次数不足 | 接口可用次数不足,请在接口列表查看 |
160 | 账号未申请该接口 | 请先在对应的接口文档页面申请接口,点此查看帮助 |
170 | Referer请求来源受限 | 设置了Referer白名单,来源Referer不在白名单内 |
230 | key错误或为空 | 请检查apikey是否填写错误,点此查看帮助 |
240 | 缺少key参数 | 请检查是否传递了key参数,如变量请检查是否赋值 |
250 | 数据返回为空 | 数据查询或转换失败,请确保输入值正确或重试 |
260 | 关键词不得为空 | 请检查word参数是否传递了空值 |
270 | 缺少有效数据 | 接口需要传递数据,请参考接口文档的说明 |
280 | 缺少必要的参数 | 缺少必填的参数,请根据接口文档检查 |
290 | 超过最大输入字节限制 | 超出最大字符,请查看对应的接口文档说明 |
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示请求成功处理。 |