节假日查询接口
  • 139
  • 6776

节假日

节假日查询接口会员免费正常调用
  • 该接口普通用户送5000+次免费调用额度
  • 高级会员每天10000次黄金会员无限次
    查询本年度节假日信息,接口返回假日名称、类型、对应农历、是否上班、调休,假期范围、假期提示、及工作日信息等。请求参数中mode可以指定是否返回每天有关的国内外节日信息。请注意字段daycode表示日期类型,为0表示工作日、为1节假日、为2双休日、为3调休日(上班),字段isnotwork表示是否需要上班,为0表示上班,为1表示休息。(数据来自国务院办公厅假日通知)
    ▼ 接口信息
  • 接口地址:http://api.tianapi.com/txapi/jiejiari/index
  • 请求示例:http://api.tianapi.com/txapi/jiejiari/index?key=APIKEY&date=2020-01-24
  • 支持协议:HTTP/HTTPS
  • 请求方式:GET/POST
  • 返回格式:UTF8 JSON
▼ 请求参数

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

名称类型必填位置示例值说明
keystringurlParam用户自己的APIKEYapi密钥
datestringurlParam2020-01-24日期,格式年-月-日
modeinturlParam0工作模式,返回节日详情
▼ 返回示例
▼ 返回参数
名称类型示例值说明
datestring2019-10-01当前阳历日期
daycodeint1日期类型,为0表示工作日、为1节假日、为2双休日、3为调休日(上班)
weekdayint2星期(数字)
cnweekdaystring星期二星期(中文)
lunaryearstring己亥农历年
lunarmonthstring九月农历月
lunardaystring初三农历日
infostring节假日日期信息
startint0假期起点
endint6假期结束
holidaystring10月1日节日日期
namestring国庆节节日名称(中文)
ennamestringNational Day节日名称(英文)
isnotworkint1是否需要上班,0为工作日,1为休息日
vacationstring2019-10-01~2019-10-07假期范围
tipstring10月1日至7日放假调休,共7天......放假提示
▼ 接口价格
用户等级每日赠送次数会员价格说明
普通会员0次免费赠送额度外的调用1天行币/次
高级会员10000次99元/年每个免费接口每天赠送1W次
黄金会员无限次299元/年每个免费接口每天都是无限次
提示:注册成为普通会员申请本接口可获得5000次免费调用额度,如项目有更高需求请点此升级会员等级。
▼ 错误状态码
错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单
130API调用频率超限API超出了分钟频率限制
140API没有调用权限该API只有特定用户才可以调用,也可能是被禁用
150接口可用次数不足接口可用次数不足,请在接口列表查看
160账号未申请该接口请先在对应的接口详情页面申请接口
170Referer请求来源受限设置了Referer防盗用功能
230key错误或为空请检查apikey是否填写错误或未正确传递
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据返回为空数据查询或转换失败
260关键词不得为空word参数不要传递null或空值
270缺少有效数据部分接口需要传递数据,请按接口说明来
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过资源字节限制超过了最大输入字节限制
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示数据请求成功。
▼ 参考代码

其他可直接使用的部分开源项目推荐。另外此处的参考代码都是get方式请求,post请求请参考此项目

活动推荐EXERCISE API 更多>

开通会员专享福利
留言反馈