节假日
节假日信息查询接口会员免费正常调用
接口支持按年、按月、按日期范围和多个日期批量查询。如按年查询（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表示休息。wage表示当日法定工资倍数，周末为两倍，法定节假日三倍（按年查询时为具体日期）。
提示信息：info字段中的普通节日、双休日和调休日可相互重叠出现（如存在daycode=3的同时info显示双休日）；节日指具体某个日期（如2021年1月1号），节假日包含整个假期（如2021年1月1号至3号）；节日范围宽泛（如会包含植树节、圣诞节），节假日指来自政府发布的有假期的节日，每年底国家公布后一周内同步更新。可通过按年查询，来判断是否更新了下一年节假日。
老用户请注意：接口新增APIS域名及优化数据结构
post方式请求时，enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式，enctype必须为multipart/form-data
参数url、base64中有特殊字符时，建议对值urlencode编码后传递
| 名称 | 类型 | 必填 | 示例值/默认值 | 说明 |
|---|---|---|---|---|
| key | string | 是 | 您自己的APIKEY（注册账号后获得） | api密钥 |
| date | string | 是 | 2021-01-01 | 查询日期或日期范围 |
| type | int | 否 | 0 | 查询类型，0批量、1按年、2按月、3范围 |
| mode | int | 否 | 0 | 查询模式，为1返回国际各类特殊纪念日信息 |
返回示例作为参考，建议以实际测试结果为准
旧接口域名json结构和现在略有不同，请查看接口信息处链接
公共参数指所有接口都会返回的参数，其中code=>200表示成功计费（查看全部状态码）
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| 公共参数 | |||
| code | int | 200 | 状态码 |
| msg | string | success | 错误信息 |
| result | object | {} | 返回结果集 |
| 应用参数 | |||
| 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"] | 调休日数组 |
| wage | int | 3 | 薪资法定倍数/按年查询时为具体日期 |
| tip | string | 10月1日至7日放假调休，共7天...... | 放假提示 |
| rest | string | 10月8日至10月10日请假2天，与周末连休可拼11天长假。 | 拼假建议 |
| 用户等级 | 免费接口数 | 每日赠送次数 | 会员价格 | 说明 |
|---|---|---|---|---|
| 免费会员 | 10个 | 100次 | 免费 | 每个免费接口每天赠送100次 |
| 高级会员 | 不限 | 1万次 | 20元/月、120元/年(限时) | 每个免费接口每天赠送1W次 |
| 黄金会员 | 不限 | 50万次 | 65元/月、390元/年(限时) | 每个免费接口每天赠送50W次 |
| 提示：系统优先使用赠送额度，超出后每次调用消耗1颗天豆（0.0001元），如项目有更高需求请点此升级会员等级。 | ||||
错误信息可能会有所调整，请根据错误状态码进行流程判断
| 错误状态码 | 错误信息 | 解释帮助 |
|---|---|---|
| 100 | 内部服务器错误 | 报此错误码请及时反馈或等待官方修复 |
| 110 | 当前API已下线 | 接口已下线无法使用，可关注相关通知 |
| 120 | API暂时维护中 | 接口暂时关闭维护中，请注意相关公告 |
| 130 | API调用频率超限 | 超过每秒请求数上限，可在控制台-接口管理中查询 |
| 140 | API没有调用权限 | 请检查是否自行在接口管理中停用或被禁用了该接口 |
| 150 | API可用次数不足 | 账号余额不足以调用接口，请在控制台中查看 |
| 160 | 账号未申请该API | 请先在接口文档页面申请该接口，点此查看说明 |
| 170 | Referer请求来源受限 | 设置了Referer白名单，但来源Referer不在白名单内 |
| 180 | IP请求来源受限 | 设置了IP白名单，但来源IP不在白名单内 |
| 190 | 当前key已限制使用 | 通常为账号被限制使用，此状态无法恢复 |
| 230 | key错误或为空 | 请检查apikey是否填写错误，点此查看帮助 |
| 240 | 缺少key参数 | 请检查是否传递了key参数或者编码格式是否符合要求 |
| 250 | 数据返回为空 | 数据查询或转换失败，请检查输入值或注意中文编码问题 |
| 260 | 参数值不得为空 | 请检查关键参数是否传递了空值 |
| 270 | 参数值不符合要求 | 参数值不符合基本格式要求，点此查看说明 |
| 280 | 缺少必要的参数 | 缺少必填的参数，请根据接口文档检查 |
| 290 | 超过最大输入字节限制 | 超出最大字符限制，请查看接口文档的说明 |
| 1开头的是系统级错误，2开头的是用户级错误，其中200代码表示请求成功处理并计费。 | ||
微信精选
菜谱查询
网络取名
中国老黄历
天气预报
二十四节气
沪公网安备31011402008730号