节假日/万年历

免费HTTPS
获取指定日期、按年、按月的节假日和万年历信息
接口ID：1
服务正常
由于测试id被频繁恶意利用，不再提供测试使用的app_id和app_secret，如需调试或者正式使用接口，请申请您专属的app_id和app_secret
  • 获取指定日期的节假日及万年历信息
  • 获取指定多个日期的节假日及万年历信息
  • 获取指定月份的节假日及万年历信息
  • 获取指定月份的指定类型节假日及万年历信息
  • 获取指定年份的节假日及万年历信息
  • 获取指定年份的指定类型节假日及万年历信息
  • 获取最近前后七个节日信息
  • 接口请求地址： https://www.mxnzp.com/api/holiday/single/{date}
  • 接口请求方式： GET
  • 请求参数格式： URL QUERY
  • 接口返回格式： APPLICATION/JSON
  • 接口请求示例： https://www.mxnzp.com/api/holiday/single/20181121?ignoreHoliday=false&app_id=不再提供请自主申请&app_secret=不再提供请自主申请
  • 接口信息备注： 获取指定日期的节假日及万年历信息

请求参数说明：


名称类型说明
date字符串日期 格式 yyyyMMdd
ignoreHoliday布尔值是否忽略节假日，仅仅获取万年历，默认值false

返回参数说明：


名称类型说明
date字符串当前日期
weekDay整型当前周第几天 1-周一 2-周二 ... 7-周日
yearTips字符串天干地支纪年法描述 例如：戊戌
type整型类型 0 工作日 1 假日 2 节假日 如果ignoreHoliday参数为true，这个字段不返回
detailsType整型类型 0 工作日 1 假日 2 普通节假日 3 三倍工资节假日 如果ignoreHoliday参数为true，这个字段不返回
typeDes字符串类型描述 比如 国庆,休息日,工作日 如果ignoreHoliday参数为true，这个字段不返回
chineseZodiac字符串属相 例如：狗
solarTerms字符串节气描述 例如：小雪
lunarCalendar字符串农历日期
suit字符串宜事项
dayOfYear整型这一年的第几天
weekOfYear整型这一年的第几周
constellation字符串星座
indexWorkDayOfMonth整型如果当前是工作日 则返回是当前月的第几个工作日，否则返回0 如果ignoreHoliday参数为true，这个字段不返回
makeUpDay整型是否补班日 0 否 1 是，因调休需要上班的周末，如果ignoreHoliday参数为true，这个字段不返回

返回示例：

{
    "code": 1,
    "msg": "数据返回成功",
    "data": {
        "date": "2018-11-21",
        "weekDay": 3,
        "yearTips": "戊戌",
        "type": 0,
        "typeDes": "工作日",
        "chineseZodiac": "狗",
        "solarTerms": "立冬后",
        "avoid": "嫁娶.安葬",
        "lunarCalendar": "十月十四",
        "suit": "破屋.坏垣.祭祀.余事勿取",
        "dayOfYear": 325,
        "weekOfYear": 47,
        "constellation": "天蝎座",
        "indexWorkDayOfMonth": 1
    }
}

错误码说明

查看所有接口通用及业务错误码，快速定位 code 与 msg 对应含义。

查看错误码