6.4 KiB
首页 企业商务 节假日 节假日接口 139 146929 节假日正常服务支持MCP 判断指定日期是否为法定节假日、调休日或工作日，并返回薪资倍数。 会员免费・升级会员畅享160+免费接口，立即升级>> 收藏 普通会员 100次/天 高级会员 1W次/天 黄金会员 50W次/天 钻石会员 不限次数
▼ 接口文档
价格
返回示例
参考代码
MCP服务
帮助
生成小程序 查询节假日信息，接口返回节日名称类型、农历信息、上班调休、工资倍数、假期范围、拼假建议、及工作日相关信息等。通过请求参数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表示休息。wage表示薪资倍数，周末为两倍，法定节假日当天为三倍其他两倍（按年查询时返回三倍薪资的具体日期）。
提示：info字段和daycode并非对应关系，建议仅用于日期类型标记；节日指某个具体日期（如2021年1月1号），节假日指整个假期（如2021年1月1号至3号）；节日范围宽泛（如会包含植树节、圣诞节），节假日指来自官方发布的有假节日，每年底政府公布后同步更新。
接入点列表：
节假日查询 相关资源：
节假日功能演示 节假日接口更新了，增加批量/范围按年按月查询 如何利用节假日API让日程规划更轻松 为什么节假日查询接口，按年查询返回250错误？ 节假日接口数据有误，怎么回事？ 节假日接口没有更新吗？ 我想知道哪天是国家规定的3倍工资呢？ 请问我如何知道节假日接口已经更新了下一年的数据呢? ▼ 接口信息 判断日期是否为官方节假日支持按年、按月和范围批量查询
接口地址：https://apis.tianapi.com/jiejiari/index?key={apiKey} 支持协议：http/https 请求方法：get/post 返回格式：utf-8 json ▼ 请求参数 上传文件时请使用标准表单格式 multipart/form-data
普通参数请使用默认表单格式 application/x-www-form-urlencoded
当参数值（如url、base64）包含特殊字符时，建议urlencode编码后传递
名称 类型 必须 示例值/默认值 说明 key string 是 您自己的ApiKey（注册账号后获得） API密钥 date string 是 2021-01-01 查询日期或日期范围 type int 是 0 查询类型，0批量、1按年、2按月、3范围 mode int 否 0 查询模式，为1同时返回中外特殊节日信息 ▼ 返回示例 接口数据示例仅作为预览参考，请以实际测试结果为准
旧接口域名返回的数据结构和现在略有不同，请查看说明
成功调用，返回内容并产生计费：
{
"msg": "success", "code": 200, "result": { "list": [ { "end": 2, "now": 0, "tip": "1月1日放假，共3天。", "date": "2021-01-01", "info": "节假日", "name": "元旦节", "rest": "2020年12月28日至2020年12月31日请假四天，与周末连休可拼七天长假。", "wage": 3, "start": 0, "enname": "NewYear", "remark": [ "2021-12-26", "2021-01-08" ], "daycode": 1, "holiday": "1月1号", "weekday": 5, "lunarday": "十八", "vacation": [ "2021-01-01", "2021-01-02", "2021-01-03" ], "cnweekday": "星期五", "isnotwork": 1, "lunaryear": "庚子", "lunarmonth": "冬月" } ] } }
失败调用，查看接口错误码释义：
{
"code": 150, "msg": "API可用次数不足" }
▼ 返回参数 公共参数指所有接口都会返回的参数，应用参数每个接口都不同
建议对返回的字段进行存在性与类型校验，可参考API安全接入指南
名称 类型 示例值 说明 公共参数 code int 200 状态码 msg string success 错误信息 result object {} 返回结果集 应用参数 end int 6 假期终点计数 now int 0 假期当前计数 tip string 10月1日至7日放假调休，共7天...... 放假提示 date string 2019-10-01 当前阳历日期 info string 节假日 文字提示，工作日、节假日、节日、双休日、调休日 name string 国庆节 节假日名称（中文） rest string 10月8日至10月10日请假2天，与周末连休可拼11天长假。 拼假建议 wage int 3 薪资法定倍数/按年查询时为具体日期 start int 0 假期起点计数 enname string National Day 节日名称（英文） remark array ["2021-12-26","2021-01-08"] 调休日数组 update boolean true/false 是否更新法定节假日（按年查询专有字段） daycode int 1 日期类型，为0表示工作日、为1节假日、为2双休日、3为调休日（上班） holiday string 10月1日 节日日期 weekday int 2 星期（数字） lunarday string 初三 农历日 vacation array ["2021-01-01","2021-01-02","2021-01-03"] 节假日数组 cnweekday string 星期二 星期（中文） isnotwork int 1 是否需要上班，0为工作日，1为休息日 lunaryear string 己亥 农历年 lunarmonth string 九月 农历月 ▼ 接口价格 本接口为会员免费类接口，可根据业务需求选择升级会员方案>>
不同会员方案仅每日调用量等配额上限不同，数据本身无区别
会员方案 免费接口数 每日调用量 QPS 价格 普通会员 10个 100次 3 免费 高级会员 不限 1万次 20 29元/月、348元/年169元/年惠 黄金会员 不限 50万次 30 89元/月、1068元/年529元/年惠 钻石会员 不限 不限次 60 3380元/年1699元/年惠 ▼ 返回状态码