节假日

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

  • 接口文档

节假日查询
接口地址: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
 

返回参数说明:

名称 类型 说明
  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

  • 万年历

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

    根据日期查询节假日安排等信息
  • Whois实时查询

    通过Whois查询API接口可以查询某域名是否已被注册,还可以根据查询到的信息联系域名的所有者,或者用来调查网站的真实信息。
  • 小微企业-详情数据

    小微企业详情信息,包括小微企业类型、行业、实施扶持政策的部门及日期、享受扶持政策的数额、依据及内容等
  • 周边企业详情

    目标区域附近的企业总数和列表

API资讯

数 据 驱 动 未 来
Data Drives The Future
新年送双重好礼
0512-88869195
数 据 驱 动 未 来
Data Drives The Future