前言
相信关注我的小伙伴们应该知道,半年前我开始维护了一套免费的通用api接口,初衷是给自己用的,顺便放出来给有需要的朋友一起用!陆陆续续维护了半年,现在接口数量也在慢慢添加,有些朋友私信我,在希望我能继续维护的同时,也希望我能把每个接口单独整理一下,看起来更加清晰,于是有了这【免费Api系列】的整理文档。
另外,如果需要总览所有接口,请移步GitHub:RollToolsApi !如果此项目对你有帮助,希望你不要吝惜手中的鼠标,帮忙点个star,并推荐给你身边的人,在此谢谢各位大佬了!
Api接口介绍
特别说明
HOST地址: 推荐使用https接口更安全:https://www.mxnzp.com/api 之前的 http://www.mxnzp.com/api 可继续使用不受影响!下文中的所有HOST需要替换成上面的http或者https域名
一、指定日期的节假日及万年历信息
-
接口说明: 获取指定日期的节假日及万年历信息
-
接口地址: [HOST]/holiday/single/{date} 【例如: [HOST]/holiday/single/20181121】
-
参数说明: date 日期 格式 yyyyMMdd
-
返回数据:
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例:
{ "code": 1, "msg": "数据返回成功", "data": { "date": "2018-11-21", "weekDay": 3, "yearTips": "戊戌", "type": 0, "typeDes": "工作日", "chineseZodiac": "狗", "solarTerms": "立冬后", "avoid": "嫁娶.安葬", "lunarCalendar": "十月十四", "suit": "破屋.坏垣.祭祀.余事勿取", "dayOfYear": 325, "weekOfYear": 47, "constellation": "天蝎座" } }
二、指定多个日期的节假日及万年历信息
-
接口说明: 获取指定多个日期的节假日及万年历信息
-
接口地址: [HOST]/holiday/multi/{dates} 【例如: [HOST]/holiday/multi/20180101,20181010,20181011】
-
参数说明: dates 日期组 格式 yyyyMMdd,yyyyMMdd,yyyyMMdd (中间用英文逗号隔开)
-
返回数据:
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例:
{ "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": "天蝎座" }, { "date": "2018-10-10", "weekDay": 3, "yearTips": "戊戌", "type": 0, "chineseZodiac": "狗", "solarTerms": "寒露后", "typeDes" : "工作日", "avoid": "造庙.嫁娶.掘井.栽种.造桥.作灶.动土", "lunarCalendar": "9-2", "suit": "祭祀.开光.出行.解除.伐木.作梁.出火.拆卸.入宅.移徙.安床.修造.造畜椆栖.扫舍", "dayOfYear": 283, "weekOfYear": 41, "constellation": "天蝎座" }, { "date": "2018-10-11", "weekDay": 4, "yearTips": "戊戌", "type": 0, "typeDes" : "工作日", "chineseZodiac": "狗", "solarTerms": "寒露后", "avoid": "入宅.上梁.斋醮.出火.谢土", "lunarCalendar": "9-3", "suit": "纳采.订盟.开市.交易.立券.会亲友.纳畜.牧养.问名.移徙.解除.作厕.入学.起基.安床.开仓.出货财.安葬.启攒.入殓.除服.成服", "dayOfYear": 284, "weekOfYear": 41, "constellation": "天蝎座" } ] }
三、指定月份所有的节假日及万年历信息
-
接口说明: 获取指定月份的节假日及万年历信息
-
接口地址: [HOST]/holiday/list/month/{date} 【例如: [HOST]/holiday/list/month/201802】
-
参数说明: date 查询的月份 格式 yyyyMM (只有年月)
-
返回数据:
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例:
{ "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": "天蝎座" }, ...中间隐藏了"2018-02-02"~"2018-02-27"的数据 { "date": "2018-02-28", "weekDay": 3, "yearTips": "戊戌", "type": 0, "chineseZodiac": "狗", "typeDes" : "工作日", "solarTerms": "雨水后", "avoid": "掘井", "lunarCalendar": "1-13", "suit": "祭祀.斋醮.裁衣.合帐.冠笄.订盟.纳采.嫁娶.入宅.安香.谢土.入殓.移柩.破土.立碑.安香.会亲友.出行.祈福.求嗣.立碑.上梁.放水", "dayOfYear": 59, "weekOfYear": 9, "constellation": "天蝎座" } ] }
四、指定月份指定类型的所有的节假日及万年历信息
-
接口说明: 获取指定月份的节假日及万年历信息
-
接口地址: [HOST]/holiday/list/month/{date}/{type} 【例如: [HOST]/holiday/list/month/201810/rest】
-
参数说明: date 查询的月份 格式 yyyyMM (只有年月),type 需要查询的类型{可选值:类型 workday 工作日 holiday 节假日 rest 休息日 festival 节日}
-
返回数据:
- month: 当前月份
- year: 当前年份
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例
{ "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": "天蝎座" }, ...中间隐藏了一部分的数据... { "date": "2018-10-28", "weekDay": 7, "yearTips": "戊戌", "type": 1, "typeDes": "休息日", "chineseZodiac": "狗", "solarTerms": "霜降后", "avoid": "出行.祈福.安葬.作灶", "lunarCalendar": "九月廿", "suit": "会亲友.嫁娶.订盟.纳采.纳婿.拆卸.修造.动土.起基.竖柱.上梁.安床.会亲友.纳财", "dayOfYear": 301, "weekOfYear": 43, "constellation": "天蝎座" } ] } ] }
五、指定年份所有的节假日及万年历信息
-
接口说明: 获取指定年份的节假日及万年历信息
-
接口地址: [HOST]/holiday//list/year/{date} 【例如: [HOST]/holiday/list/year/2018】
-
参数说明: date 查询的年份 格式 yyyy (只有年份)
-
返回数据:
- month: 当前月份
- year: 当前年份
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例:
{ "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": "天蝎座" }, ...中间隐藏了"2018-01-02"~"2018-01-30"的数据 { "date": "2018-01-31", "weekDay": 3, "yearTips": "丁酉", "type": 0, "chineseZodiac": "鸡", "typeDes" : "工作日", "solarTerms": "大寒后", "avoid": "嫁娶.入殓.安葬.出行", "lunarCalendar": "12-15", "suit": "塑绘.开光.沐浴.冠笄.会亲友.作灶.放水.造畜椆栖", "dayOfYear": 31, "weekOfYear": 5, "constellation": "天蝎座" } ] }, ...中间隐藏了02月到11月的数据 { "month": 12, "days": [ { "date": "2018-12-01", "weekDay": 6, "yearTips": "戊戌", "type": 1, "chineseZodiac": "狗", "typeDes" : "休息日", "solarTerms": "小雪后", "avoid": "作灶.治病", "lunarCalendar": "10-24", "suit": "祭祀.祈福.订盟.纳采.裁衣.拆卸.修造.动土.起基.安床.移徙.入宅.安香.入殓.移柩.安葬.谢土.赴任.进人口.会亲友", "dayOfYear": 335, "weekOfYear": 48, "constellation": "天蝎座" }, ...中间隐藏了"2018-12-02"~"2018-12-30"的数据 { "date": "2018-12-31", "weekDay": 1, "yearTips": "戊戌", "type": 0, "chineseZodiac": "狗", "solarTerms": "冬至后", "avoid": "开市.破土", "lunarCalendar": "10-25", "suit": "祭祀.沐浴.安床.纳财.畋猎.捕捉", "dayOfYear": 365, "weekOfYear": 1, "constellation": "天蝎座" } ] } ] }
六、指定年份指定类型的所有的节假日及万年历信息
-
接口说明: 获取指定月份的节假日及万年历信息
-
接口地址: [HOST]/holiday/list/year/{date}/{type} 【例如: [HOST]/holiday/list/year/2018/rest】
-
参数说明: date 查询的月份 格式 yyyy (只有年份),type 需要查询的类型{可选值:类型 workday 工作日 holiday 节假日 rest 休息日 festival 节日}
-
返回数据:
- month: 当前月份
- year: 当前年份
- date: 当前日期
- weekDay: 当前周第几天 1-周一 2-周二 … 7-周日
- yearTips: 天干地支纪年法描述 例如:戊戌
- type: 类型 0 工作日 1 假日 2 节假日
- typeDes: 类型描述 比如 国庆,休息日,工作日
- chineseZodiac: 属相 例如:狗
- solarTerms: 节气描述 例如:小雪
- lunarCalendar: 农历日期
- suit: 宜事项
- dayOfYear: 这一年的第几天
- weekOfYear: 这一年的第几周
- constellation: 星座
-
数据样例
{ "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": "天蝎座" }, ...中间还有一些数据没有显示... { "date": "2018-01-28", "weekDay": 7, "yearTips": "丁酉", "type": 1, "typeDes": "休息日", "chineseZodiac": "鸡", "solarTerms": "大寒后", "avoid": "祈福.嫁娶.造庙.安床.谢土", "lunarCalendar": "腊月十二", "suit": "纳采.订盟.祭祀.求嗣.出火.塑绘.裁衣.会亲友.入学.拆卸.扫舍.造仓.挂匾.掘井.开池.结网.栽种.纳畜.破土.修坟.立碑.安葬.入殓", "dayOfYear": 28, "weekOfYear": 4, "constellation": "天蝎座" } ] }, ...中间有2月到11月的数据没有展示... { "month": 12, "year": 2018, "days": [ { "date": "2018-12-01", "weekDay": 6, "yearTips": "戊戌", "type": 1, "typeDes": "休息日", "chineseZodiac": "狗", "solarTerms": "小雪后", "avoid": "作灶.治病", "lunarCalendar": "十月廿四", "suit": "祭祀.祈福.订盟.纳采.裁衣.拆卸.修造.动土.起基.安床.移徙.入宅.安香.入殓.移柩.安葬.谢土.赴任.进人口.会亲友", "dayOfYear": 335, "weekOfYear": 48, "constellation": "天蝎座" }, ...中间还有一些数据没有显示... { "date": "2018-12-30", "weekDay": 7, "yearTips": "戊戌", "type": 1, "typeDes": "元旦", "chineseZodiac": "狗", "solarTerms": "冬至后", "avoid": null, "lunarCalendar": "冬月廿四", "suit": "塑绘.斋醮.出行.拆卸.解除.修造.移徙.造船.入殓.除服.成服.移柩.启攒.修坟.立碑.谢土", "dayOfYear": 364, "weekOfYear": 52, "constellation": "天蝎座" } ] } ] }
相关说明
这个接口是目前所有接口中使用量最多的一个,所以放到了系列的第一篇来介绍!这个接口中的数据包含从2002年到2019年17年的数据。至于为什么没有2002年之前的数据以及为什么为什么没有2019年之后的数据,我需要说明一下:【中国政府网】 每年年底会公布次年的节假日安排,所以到目前为止,只能收集2019的数据,在2002年之前,其实没有很明确的节假日概念和相关数据,所有无法收集相关数据。
至于数据的更新,会在有新信息发布的同时去跟进处理,确保尽量给大家准确的数据。
至于这些接口能做什么,相信作为本服务使用量最大的接口,应该会给你一定的启发。
结语
简书首页,链接是 https://www.jianshu.com/u/123f97613b86
掘金首页,链接是 https://juejin.im/user/5838d57fac502e006c1708bc
Github首页,链接是 https://github.com/MZCretin
CSDN首页,链接是 http://blog.csdn.net/u010998327
我是Cretin,一个可爱的油腻大叔。