1、节假日万年历API接口，免费好用

1、前言

节假日万年历接口，这个是RollToolsApi通用系列接口的其中一个，内部包含了7个小接口，能实现查询指定日期/月份/年份/时间范围的节假日和万年历信息，万年历的信息包含农历信息，宜忌等信息。这个接口的主要特点是，返回某个节日是否是工作日，节日和节假日，其准确度和国务院每年的通知完全匹配。

RollToolsApi通用系列接口包含多很多免费通用的API接口，利用这些接口可以帮你实现去开发出很多功能丰富，服务稳定的小程序，APP或者网页，无论是练手还是实战都是不错的选择。所有接口的列表可以在此查看 https://www.mxnzp.com/doc/list

2、接口明细

注意：app_id和app_secret是临时秘钥，如果真正使用，需要去https://www.mxnzp.com申请属于自己的专属秘钥。

2.1 获取指定日期的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday/single/{date}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/single/20181121?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定日期的节假日及万年历信息

• 返回示例：

  {
      "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
      }
  }
  

2.2 获取指定多个日期的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday/multi/{dates}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/multi/20180101,20181010,20181011?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定多个日期的节假日及万年历信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功",
      "data": [
          {
              "date": "2018-01-01",
              "weekDay": 1,
              "yearTips": "丁酉",
              "type": 2,
              "chineseZodiac": "鸡",
              "solarTerms": "冬至后",
              "avoid": "出行.安葬.修坟.开市",
              "lunarCalendar": "11-15",
              "typeDes" : "元旦",
              "suit": "祭祀.塑绘.开光.裁衣.冠笄.嫁娶.纳采.拆卸.修造.动土.竖柱.上梁.安床.移徙.入宅.安香.结网.捕捉.畋猎.伐木.进人口.放水",
              "dayOfYear": 1,
              "weekOfYear": 1,
              "constellation": "天蝎座",
              "indexWorkDayOfMonth": 1
          },
          ...这个地方只显示了一条
      ]
  }
  

2.3 获取指定月份的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday/list/month/{date}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/list/month/201802?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定月份的节假日及万年历信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功",
      "data": [
          {
              "date": "2018-02-01",
              "weekDay": 4,
              "yearTips": "丁酉",
              "type": 0,
              "chineseZodiac": "鸡",
              "typeDes" : "工作日",
              "solarTerms": "大寒后",
              "avoid": "开仓.嫁娶.移徙.入宅",
              "lunarCalendar": "12-16",
              "suit": "祭祀.沐浴.祈福.斋醮.订盟.纳采.裁衣.拆卸.起基.竖柱.上梁.安床.入殓.除服.成服.移柩.启攒.挂匾.求嗣.出行.合帐.造畜椆栖",
              "dayOfYear": 32,
              "weekOfYear": 5,
              "constellation": "天蝎座",
              "indexWorkDayOfMonth": 1
          },
          ...只显示了一部分数据
      ]
  }
  

2.4 获取指定月份的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday/list/month/{date}/{type}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/list/month/201810/rest?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定月份的节假日及万年历信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功",
      "data": [
          {
              "month": 10,
              "year": 2018,
              "days": [
                  {
                      "date": "2018-10-13",
                      "weekDay": 6,
                      "yearTips": "戊戌",
                      "type": 1,
                      "typeDes": "休息日",
                      "chineseZodiac": "狗",
                      "solarTerms": "寒露后",
                      "avoid": "开市.交易.祭祀.入宅.安葬",
                      "lunarCalendar": "九月初五",
                      "suit": "捕捉.畋猎.余事勿取",
                      "dayOfYear": 286,
                      "weekOfYear": 41,
                      "constellation": "天蝎座",
                      "indexWorkDayOfMonth": 1
                  },
                  ...中间隐藏了一部分的数据...
              ]
          }
      ]
  }
  

2.5 获取指定年份的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday//list/year/{date}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/list/year/2018?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定年份的节假日及万年历信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功",
      "data": [
          {
              "month": 1,
              "year": 2018,
              "days": [
                  {
                      "date": "2018-01-01",
                      "weekDay": 1,
                      "yearTips": "丁酉",
                      "type": 2,
                      "chineseZodiac": "鸡",
                      "solarTerms": "冬至后",
                      "typeDes" : "元旦",
                      "avoid": "出行.安葬.修坟.开市",
                      "lunarCalendar": "11-15",
                      "suit": "祭祀.塑绘.开光.裁衣.冠笄.嫁娶.纳采.拆卸.修造.动土.竖柱.上梁.安床.移徙.入宅.安香.结网.捕捉.畋猎.伐木.进人口.放水",
                      "dayOfYear": 1,
                      "weekOfYear": 1,
                      "constellation": "天蝎座",
                      "indexWorkDayOfMonth": 1
                  },
                  ...中间隐藏了"2018-01-02"~"2018-01-30"的数据
              ]
          },
          ...中间隐藏了02月到11月的数据
      ]
  }
  

2.6 获取指定月份的节假日及万年历信息

• 接口地址： https://www.mxnzp.com/api/holiday/list/year/{date}/{type}

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/list/year/2018/rest?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取指定月份的节假日及万年历信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功，域名已经成功备案，为了更优雅的调用，不久后将废弃8091端口，请尽快使用新域名直接调用，多有不便敬请谅解",
      "data": [
          {
              "month": 1,
              "year": 2018,
              "days": [
                  {
                      "date": "2018-01-06",
                      "weekDay": 6,
                      "yearTips": "丁酉",
                      "type": 1,
                      "typeDes": "休息日",
                      "chineseZodiac": "鸡",
                      "solarTerms": "小寒后",
                      "avoid": "嫁娶.开市.入宅.安床.破土.安葬",
                      "lunarCalendar": "冬月廿",
                      "suit": "祭祀.斋醮.纳财.捕捉.畋猎",
                      "dayOfYear": 6,
                      "weekOfYear": 1,
                      "constellation": "天蝎座",
                      "indexWorkDayOfMonth": 1
                  },
                  ...中间还有一些数据没有显示...
              ]
          },
          ...中间有2月到11月的数据没有展示...
      ]
  }
  

2.7 获取最近前后七个节日信息

• 接口地址： https://www.mxnzp.com/api/holiday/recent/list

• 返回格式： JSON

• 请求方式： GET

• 请求示例： https://www.mxnzp.com/api/holiday/recent/list?app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

• 接口备注： 获取最近前后七个节日信息

• 返回示例：

  {
      "code": 1,
      "msg": "数据返回成功",
      "data": [
          {
              "date": "2019年07月07日",
              "lunarDate": "2019年06月05日",
              "holidayName": "国际合作节",
              "residueDays": -34,
              "lunarHoliday": false
          },
          ...这里只显示了一条
      ]
  }