节假日信息查询接口
  • 139
  • 45919

节假日

节假日信息查询接口免费接口正常调用
  • 该接口免费会员每天赠送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=3的同时info显示双休日);节日指具体某个日期(如2021年1月1号),节假日包含整个假期(如2021年1月1号至3号);节日范围宽泛(如会包含植树节、圣诞节),节假日指来自中国官方发布的有假期的节日,每年底同步更新。

    ▼ 接口信息
  • 接口地址:http://api.tianapi.com/txapi/jiejiari/index
  • 请求示例:http://api.tianapi.com/txapi/jiejiari/index?key=APIKEY&date=2021-01-01
  • 支持协议:HTTP/HTTPS
  • 请求方式:GET/POST
  • 返回格式:UTF8 JSON
▼ 请求参数

post请求时,enctype应为application/x-www-form-urlencoded

请求参数中有url或特殊字符时,应该对值urlencode编码下

名称类型必填示例值/默认值说明
keystring您自己的APIKEY(注册账号后获得)api密钥
datestring2021-01-01查询日期或日期范围
modeint0工作模式,为1返回当天全部相关节日信息
typeint0查询类型,0批量、1按年、2按月、3范围
▼ 返回示例

返回示例作为参考,建议以实际测试结果为准

▼ 返回参数
名称类型示例值说明
datestring2019-10-01当前阳历日期
daycodeint1日期类型,为0表示工作日、为1节假日、为2双休日、3为调休日(上班)
weekdayint2星期(数字)
cnweekdaystring星期二星期(中文)
lunaryearstring己亥农历年
lunarmonthstring九月农历月
lunardaystring初三农历日
infostring节假日文字提示,工作日、节假日、节日、双休日
startint0假期起点计数
nowint0假期当前计数
endint6假期终点计数
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天长假。拼假建议
▼ 接口价格
用户等级免费接口数每日赠送次数会员价格说明
免费会员15个100次免费每个免费接口每天赠送100次
高级会员15个1万次20元/月、120元/年每个免费接口每天赠送1W次
黄金会员不限50万次65元/月、390元/年每个免费接口每天赠送50W次
提示:系统优先使用赠送额度,超出后每次调用消耗1颗天豆(0.0001元),如项目有更高需求请点此升级会员等级。
▼ 错误状态码

错误消息可能会有所调整,请根据错误代码进行流程判断

错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单,来源IP不在白名单内
130API调用频率超限API调用频率QPS超出限制
140API没有调用权限请检查接口是否被自行停用或被官方禁用
150接口可用次数不足接口可用次数不足,请在接口列表查看
160账号未申请该接口请先在对应的接口文档页面申请接口,点此查看帮助
170Referer请求来源受限设置了Referer白名单,来源Referer不在白名单内
230key错误或为空请检查apikey是否填写错误,点此查看帮助
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据返回为空数据查询或转换失败,请确保输入值正确或重试
260参数值不得为空请检查查询参数是否传递了空值
270缺少有效数据接口需要传递数据,请参考接口文档的说明
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过最大输入字节限制超出最大字符,请查看对应的接口文档说明
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示请求成功处理。
▼ 参考代码

其他可直接下载使用的部分开源项目推荐。

此处的参考代码都是get方式请求,post请求请参考此项目

此处代码并非完整项目,仅供参考,实际使用请根据本地开发环境修改。

活动推荐EXERCISE 更多>

开通会员专享福利
联系客服