节假日

查询节假日信息,接口返回节日名称类型、农历信息、上班调休、工资倍数、假期范围、拼假建议、及工作日相关信息等。

  • 接口文档

节假日查询
接口地址:http://apis.juhe.cn/fapigx/jiejiari/query
请求方式:get/post
返回类型:json
接口描述:查询节假日信息,接口返回节日名称类型、农历信息、上班调休、工资倍数、假期范围、拼假建议、及工作日相关信息等。通过请求参数mode还可以指定是否返回当天有关的国内外节日信息
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 您在聚合平台申请的接口凭证(可在个人中心进行查看)
  date string 查询日期,格式如:2024-01-01
  type int 查询类型,0批量、1按年、2按月、3范围,默认;0
  mode string 查询模式,为1返回国际各类特殊纪念日信息,默认:0
 

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://apis.juhe.cn/fapigx/jiejiari/query?key=key&date%09=xxx&type%09=&mode="

返回参数说明:

名称 类型 说明
  error_code int 返回状态码
  reason string 返回原因
  result object 结果对象
  date string 当前阳历日期
  daycode int 日期类型,为0表示工作日、为1节假日、为2双休日、3为调休日(上班)
  weekday int 星期(数字)
  cnweekday string 星期(中文)
  lunaryear string 农历年
  lunarmonth string 农历月
  lunarday string 农历日
  info string 文字提示,工作日、节假日、节日、双休日
  start int 假期起点计数
  now int 假期当前计数
  end int 假期终点计数
  holiday string 节日日期
  name string 节假日名称(中文)
  enname string Day
  isnotwork int 是否需要上班,0为工作日,1为休息日
  vacation array 节假日数组
  remark array 调休日数组
  wage int 薪资法定倍数/按年查询时为具体日期
  tip string 放假提示
  rest string 拼假建议
 

JSON返回示例:JSON在线格式化工具 >

      {
    "reason": "success",
    "result": {
        "list": [
            {
                "date": "2023-01-01",
                "daycode": 2,
                "weekday": 0,
                "cnweekday": "星期日",
                "lunaryear": "壬寅",
                "lunarmonth": "腊月",
                "lunarday": "初十 ",
                "info": "双休日",
                "start": 0,
                "now": 0,
                "end": 0,
                "holiday": "1月1日",
                "name": "中国元旦",
                "enname": "New Year's Day",
                "isnotwork": 1,
                "vacation": "",
                "remark": "",
                "wage": 2,
                "tip": "",
                "rest": ""
            }
        ]
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  273600 网络超时,请稍后重试
  273601 日期格式错误
  273602 数据异常
  273603 其他错误,具体看描述

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
节假日
941
申请次数
736
ID
0
收藏次数

推荐API

  • 万年历

    指定日期查询当日的星期、星座、农历、生肖、天干地支、岁次、黄历相关的福神、喜神、宜忌等信息,可以进行阴阳历转换。
  • 节假日信息查询

    根据日期查询节假日安排等信息
  • 2024欧洲杯赛程

    2024年欧洲杯小组赛、1/8决赛、1/4决赛、半决赛、季军赛、决赛赛程及积分榜、新闻动态
  • 活体人脸实名认证H5版

    本服务搭载真人检测和人脸比对等生物识别技术,配合权威数据源验证,可快速校验自然人的真实身份。支持PC和移动端H5网页接入。
  • 营运车判定查询

    输入车牌号码或车架号,判定是否属于营运车辆。

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future