节假日API接口 - 天聚数行TianAPI

139
138675

节假日

法定节假日信息查询判断会员免费正常MCP

该接口普通会员每天赠送100次调用额度
高级会员1万次/天黄金会员50万次/天

申请接口在线测试

▼ 接口文档
价格
返回示例
参考代码
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号）；节日范围宽泛（如会包含植树节、圣诞节），节假日指来自官方发布的有假节日，每年底政府公布后同步更新。

接入点列表：

节假日查询

相关资源：

▼ 接口信息

判断日期是否为官方节假日支持按年、按月和范围批量查询

接口地址：https://apis.tianapi.com/jiejiari/index
请求示例：https://apis.tianapi.com/jiejiari/index?key=你的APIKEY&date=2021-01-01&type=0
支持协议：http/https
请求方式：get/post
返回格式：utf-8 json

▼ 请求参数

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	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	假期终点计数
update	boolean	true/false	是否更新法定节假日（按年查询专有字段）
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天长假。	拼假建议

▼ 接口价格

本接口为会员免费类接口，如业务有更高配额需求可点此升级会员

用户等级	免费接口数	每日调用量	QPS	会员价格
普通会员	10个	100次	5-10	免费
高级会员	不限	1万次	20	20元/月、~~240元/年~~120元/年惠
黄金会员	不限	50万次	30	65元/月、~~720元/年~~390元/年惠
钻石会员	不限	不限次	60	~~3380元/年~~1690元/年惠

▼ 返回状态码

错误信息可能会有所调整，请根据错误状态码(code)进行流程判断

错误状态码	错误信息	解释帮助
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表示请求成功处理并计费。