法定节假日信息查询判断
  • 139
  • 117192

节假日

法定节假日信息查询判断会员免费正常服务
  • 该接口普通会员每天赠送100次调用额度
  • 高级会员1万次/天黄金会员50万次/天
查询节假日信息,接口返回节日名称类型、农历信息、上班调休、工资倍数、假期范围、拼假建议、及工作日相关信息等。通过请求参数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编码后传递

名称类型必须示例值/默认值说明
keystring您自己的APIKEY(注册账号后获得)API密钥
datestring2021-01-01查询日期或日期范围
typeint0查询类型,0批量、1按年、2按月、3范围
modeint0查询模式,为1同时返回中外特殊节日信息
▼ 返回示例

接口数据样例仅作为预览参考,请以实际测试结果为准

旧域名返回的json结构和现在略有不同,请点击此处查看说明

	
	

成功调用,code=>200并产生计费:

错误调用,查看接口错误码释义:

▼ 返回参数

公共参数指所有接口都会返回的参数,应用参数每个接口都不同

名称类型示例值说明
公共参数
codeint200状态码
msgstringsuccess错误信息
resultobject{}返回结果集
应用参数
datestring2019-10-01当前阳历日期
daycodeint1日期类型,为0表示工作日、为1节假日、为2双休日、3为调休日(上班)
weekdayint2星期(数字)
cnweekdaystring星期二星期(中文)
lunaryearstring己亥农历年
lunarmonthstring九月农历月
lunardaystring初三农历日
infostring节假日文字提示,工作日、节假日、节日、双休日、调休日
startint0假期起点计数
nowint0假期当前计数
endint6假期终点计数
updatebooleantrue/false是否更新法定节假日(按年查询专有字段)
holidaystring10月1日节日日期
namestring国庆节节假日名称(中文)
ennamestringNational Day节日名称(英文)
isnotworkint1是否需要上班,0为工作日,1为休息日
vacationarray["2021-01-01","2021-01-02","2021-01-03"]节假日数组
remarkarray["2021-12-26","2021-01-08"]调休日数组
wageint3薪资法定倍数/按年查询时为具体日期
tipstring10月1日至7日放假调休,共7天......放假提示
reststring10月8日至10月10日请假2天,与周末连休可拼11天长假。拼假建议
▼ 接口价格
用户等级免费接口数每日可用次数会员价格说明
普通会员10个100次免费每个免费接口100次/天
高级会员不限1万次20元/月、120元/年(限时)每个免费接口1W次/天
黄金会员不限50万次65元/月、390元/年(限时)每个免费接口50W次/天
本接口为会员免费类接口,如业务有更高需求可点此升级会员获得更高每日请求配额(年付限时优惠)
▼ 返回状态码

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

错误状态码错误信息解释帮助
100内部服务器错误报此错误码请及时反馈或等待官方修复
110当前API已下线接口已下线无法使用,可关注相关通知
120API暂时维护中接口暂时关闭维护中,请注意相关公告
130API调用频率超限超过每秒请求数上限,可在控制台-接口管理中查询
140API没有调用权限请检查是否自行在接口管理中停用或被禁用了该接口
150API可用次数不足免费类接口套餐超限或计次类接口余额不足,点此查看说明
160账号未申请该API请先在接口文档页面申请该接口,点此查看说明
170Referer请求来源受限设置了Referer白名单,但来源Referer不在白名单内
180IP请求来源受限设置了IP白名单,但来源IP不在白名单内
190当前key不可用通常为账号无效,此状态无法恢复
230key错误或为空请检查apikey是否填写错误,点此查看帮助
240缺少key参数请检查是否传递了key参数或者编码格式是否符合要求
250数据返回为空数据查询或转换失败,请检查输入值或注意中文编码问题
260参数值不得为空请检查关键参数是否传递了空值
270参数值不符合要求参数值不符合基本格式要求,点此查看说明
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过最大输入限制参数值超过输入范围,请查看接口文档的说明
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。
▼ 参考代码

此处代码仅演示关键请求片段,实际使用请根据具体环境修改

如需深入学习参考,可点击此处查看部分第三方完整开源项目

活动推荐EXERCISE 更多>

开通会员专享福利
工单 客服