天聚数行API接口平台

天行数据节假日接口一直以来，深受各位开发者的欢迎。接口返回的数据全面具体、维度广泛。但一直以来，只支持单个日期的查询，在复杂场景下不够方便。因此，经过升级更新，现在支持了多种类型的查询方式，让大家使用起来更方便。

天行数据节假日接口可以查询本年度指定日期节假日相关信息，接口返回假日名称、类型、对应农历、是否上班、调休，工资倍数、假期范围、假期提示、拼假建议、及工作日信息等。通过请求参数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）

1、按年查询

按年查询只返回中国境内官方节假日列表，一般每年底11月左右由国务院办公厅公布。按年查询可通过update字段判断是否更新了下一年的官方节假日，请注意，由于元旦假期并不一定是从1月1号开始的，可能存在跨年，因此查询当年之前的节假日列表可能存在两个元旦的情况。此外，按年查询时wage字段返回的是三倍薪资的具体日期。

2、按月查询

按月查询需指定type参数为2，date如果传递的是年月如2020-11，返回从该月第一天到最后一天所有日期数组。如果带上了年月日如2020-11-10，则为返回从该日期到该月最后一天的所有日期数组。

3、按范围查询

按日期范围查询需指定type参数为3，此时date参数应该传递一个有起点和终点的日期范围，以波浪号分隔。如2020-11-02~2020-11-20，此时接口会返回从起点日期到终点日期所有日期数组。

4、批量查询

批量查询日期信息时，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