天行数据节假日接口一直以来,深受各位开发者的欢迎。接口返回的数据全面具体、维度广泛。但一直以来,只支持单个日期的查询,在复杂场景下不够方便。因此,经过升级更新,现在支持了多种类型的查询方式,让大家使用起来更方便。
天行数据节假日接口可以查询本年度指定日期节假日相关信息,接口返回假日名称、类型、对应农历、是否上班、调休,工资倍数、假期范围、假期提示、拼假建议、及工作日信息等。通过请求参数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)
按年查询只返回中国境内官方节假日列表,一般每年底11月左右由国务院办公厅公布。按年查询可通过update字段判断是否更新了下一年的官方节假日,请注意,由于元旦假期并不一定是从1月1号开始的,可能存在跨年,因此查询当年之前的节假日列表可能存在两个元旦的情况。此外,按年查询时wage字段返回的是三倍薪资的具体日期。
按月查询需指定type参数为2,date如果传递的是年月如2020-11,返回从该月第一天到最后一天所有日期数组。如果带上了年月日如2020-11-10,则为返回从该日期到该月最后一天的所有日期数组。
按日期范围查询需指定type参数为3,此时date参数应该传递一个有起点和终点的日期范围,以波浪号分隔。如2020-11-02~2020-11-20,此时接口会返回从起点日期到终点日期所有日期数组。
批量查询日期信息时,date参数传递可以任意组合两个或多个日期,如2020-10-20,2020-11-12。此时接口会返回包含这两个时间的日期数组。
请注意,按年查询只返回中国官方节假日信息;按月查询如未指定日期,就是默认为从该月第一天到最后一天;按范围查询,起点和终点用波浪号~分隔;按多个日期批量查询则用英文逗号分隔。无论哪种查询方式,包含的总日期数不能超过31天。
返回字段daycode表示日期类型,为0表示工作日、为1节假日、为2双休日、为3调休日(上班),字段isnotwork表示是否需要上班,为0表示上班,为1表示休息。wage表示当日法定工资倍数,其中周末为两倍,法定节假日当天(或规定日期)为三倍,法定节假日的其他时间为两倍。注意,按年查询时wage参数返回的是三倍工资的具体日期。
ps.法定节假日数据来自国务院办公厅假日通知,一般为年底发布后一周内同步更新。
接口文档地址:https://www.tianapi.com/apiview/139