- API
- 订阅方案
- 错误码参照
- 技术支持
- 问题反馈
-
服务相关
-
节假日API接口,查询指定日期是否为节假日,查询下一个周末或法定节假日,查询下一个工作日,批量查询节假日信息,数据来源国务院节假日公告,每年更新一次
节假日API接口应用场景
-
生成年度节假日表
各类系统、网站最新节假日数据调用节假日API生成年度节假日表,供各类系统、网站等生成最新的年度节假日数据 -
小程序、轻应用、小部件、云函数、各类终端智能假期提示
丰富程序功能,提升用户体验通过节假日API接口,每日获取最新节假日提示,丰富程序功能,提升用户体验 -
节假日、周末、调班、调休、工作日查询
指定日期或时间段内节假日工作日信息查询指定日期或时间段内节假日、周末、调班、调休、工作日信息,规划业务时间周期、方案等
节假日API接口简介
每年的节假日数据都会不同,因为农历节日如春节、清明、中秋等是变动的,同时调休调班安排也会根据周末进行调整,月萌API提供人工及时维护的节假日API,方便各类系统快速有效集成。
节假日API接口支持2007年至2022年的法定节假日查询。
在使用节假日API接口时,可根据实际业务需求,将数据缓存到本地服务器使用或直接使用月萌API在线服务。如仅需要某段时间内节假日安排,可直接将数据缓存或入库至本地服务器;如需动态查询某日后的节假日、工作日等功能,则直接使用月萌API在线服务。
节假日数据源: 中国政府网 http://www.gov.cn/zhengce/xxgkzl.htm (注:搜索节假日即可)
节假日API接口功能列表
- 1查询指定日期的节假日信息
- 2查询指定日期区间段节假日信息
- 3查询指定日期的下一个节假日(开始日期)
- 4查询指定日期的下一个工作日(包含调班)
- 5指定日期(默认今日)的节假日信息及供机器人播报的节假日信息文本语料
- 6指定日期下一日(默认明日)的节假日信息及供机器人播报的节假日信息文本语料
- 7下一个节假日信息及供机器人播报的节假日信息文本语料
功能说明请参见接口说明及API文档。
节假日API接口常见问题
-
节假日API接口会更新频率是多少?
节假日信息更新分为定期更新和临时更新。法定节假日,由国务院办公厅每年10月左右发布下一年度的节假日安排的通知,月萌API使用网页监控自动检测是否发布更新,并自动提取最新节假日安排,经人工审核后进行数据发布。节假日API除每年定期更新外,会关注各类临时通知(全国性放假通知)进行节假日信息更新。
-
节假日API接口是否包含地方或少数民族节假日?
不包含,目前仅包含全国性的法定节假日,地方或少数民族节假日较复杂,如果需要可以在问题反馈区留言。
-
共享版每用户每日可访问10000次?
对于开发过程及小规模应用,每日10000次调用应当是非常充足了,更多需求可以使用众筹版等。特殊情况可联系站长处理增加限额。
我们的优势
数据云端存储
数据云端存储, 支持不同设备不同场景访问
多语言支持
使用HTTP协议+JSON/XML, 只要支持HTTP协议的语言都能轻松访问
使用方便, 订阅即用
接口访问灵活简便, 可根据调用参数实现多种场景需求, 发送所需请求, 即刻获取数据
高可用集群支持
我们有高配置服务器集群, 为服务高效高可用保驾护航
价格优惠
利用平台优势, 价格比客户自行开发维护成本更具性价比, 服务定价仅基于服务器分摊成本及维护售后费用, 价格透明, 无二次收费
多种订阅方案满足多样化需求
接口服务支持多种订阅方案, 还可根据客户实际需求定制服务, 如提高并发量, 使用独立服务器(集群), 主动推送数据等
月萌API使用流程
注:黄色为用户操作环节
注册账号1用户需在本站注册账号后才能正常使用月萌API提供的API服务选择API服务并提交订阅2用户可在共享数据接口获取所需服务, 在API详情页选择订阅方案并提交订阅,
若是免费订阅方案, 用户可立即开始使用接口服务,
若是收费订阅方案, 请支付后联系站长开通使用客服开通服务3客服核验订阅后开通订阅中API服务用户使用接口4API服务开通后, 用户可根据API详情页中API文档开发接口与用户系统配套对接程序.
如有问题可联系服务商提交售后工单或在问题反馈查找解决方案.
若有需要, 本站可提供有偿API对接服务, 详询客服.用户提交售后工单5用户使用过程中遇到问题, 可向服务商提交售后工单或在相应问题反馈提问解决客服处理售后工单6客服接到售后工单后一个工作日内进行响应处理 -
-
节假日API接口功能
节假日API接口主要包含以下功能,若需更多功能可以在问题反馈区留言
- 1查询指定日期的节假日信息
- 2查询指定日期区间段节假日信息
- 3查询指定日期的下一个节假日(开始日期)
- 4查询指定日期的下一个工作日(包含调班)
- 5指定日期(默认今日)的节假日信息及供机器人播报的节假日信息文本语料
- 6指定日期下一日(默认明日)的节假日信息及供机器人播报的节假日信息文本语料
- 7下一个节假日信息及供机器人播报的节假日信息文本语料
查询指定日期的节假日信息
参数 是否必填 说明 date 否 查询日期,格式yyyy-MM-dd, 如2022-01-20(2020年1月20日),默认为今日 weekend 否 指定周末,默认为6,7表示周六和周日,可根据实际休息时间指定周几为周末,多个星期使用逗号分隔。 参数均包含默认值,都不设置时表示查询今日的周末、节假日信息,且周末指周六和周日。
date参数可设置为2007年及以后的任意日期,无节假日信息时返回错误码MNA-100010,详见错误码参照
weekend参数作用:针对非周六周日双休的情况,有些公司实行单休如仅休周日,此时可以设置weekend为7,有些公司根据业务错峰休周末,如周二周三休假,可设置为2,3。
返回样例:(可通过在线调试工具查看返回样例,可直接下载demo运行查看)
{ "status": "success", "message": "", "time": 1641140610, "data": { "date": "2022-01-03", "type": 2, "offwork": true, "name": "元旦", "wage": 2, "descr": "元旦休假", "week": 1, "weekname": "周一" } }
查询指定日期区间段节假日信息
参数 是否必填 说明 start 否 指定日期区间开始日期,格式yyyy-MM-dd, 如2022-01-20(2020年1月20日),默认为今日 end 否 指定日期区间段结束日期,格式yyyy-MM-dd,如2022-01-20表示2022年1月20日 weekend 否 指定周末,默认为6,7表示周六和周日,可根据实际休息时间指定周几为周末,多个星期使用逗号分隔。 start/end可以设置为2007年后任意日期区间,可以根据业务需求设置合理区间,无节假日信息时返回错误码MNA-100010,详见错误码参照。
weekend参数作用:针对非周六周日双休的情况,有些公司实行单休如仅休周日,此时可以设置weekend为7,有些公司根据业务错峰休周末,如周二周三休假,可设置为2,3。
返回样例:
{ "status": "success", "message": "", "time": 1641144545, "data": [{ "date": "2022-01-03", "type": 2, "offwork": true, "name": "元旦", "wage": 2, "descr": "元旦休假", "week": 1, "weekname": "周一" }, { "date": "2022-01-04", "type": 0, "offwork": false, "name": "工作日", "wage": 1, "descr": "", "week": 2, "weekname": "周二" }, { "date": "2022-01-05", "type": 0, "offwork": false, "name": "工作日", "wage": 1, "descr": "", "week": 3, "weekname": "周三" }] }
查询指定日期的下一个节假日
参见功能1查询指定日期的节假日信息,输入参数多一个下一个节假日是否包含周末,其它相同,返回值相同。
查询指定日期的下一个工作日
参见功能1查询指定日期的节假日信息。
指定日期的节假日信息及语料
参数 是否必填 说明 date 否 查询日期,格式yyyy-MM-dd, 如2022-01-20(2020年1月20日),默认为今日 weekend 否 指定周末,默认为6,7表示周六和周日,可根据实际休息时间指定周几为周末,多个星期使用逗号分隔。 forcast 否 预报N天内的下一休息日,默认5天内,包含周末和节假日 date/weekend字段与前文相同
forcast指预报指定天数内(默认5天内)的放假信息(包含周末、节假日),仅作用于返回的chat文本语料中,进行节假日的智能预报。
语料包含如:
- 今天是国庆节,可以放松休息啦!
- 今天是国庆节,继续放假!
- 今天是国庆节,继续放假!明天要上班了哦~
- 今天是国庆节调班,辛苦了!
- 今天是工作日,加油!
- 明天就是国庆节啦!
- 后天就是国庆节啦!
- 还有三天就是国庆节啦!
语料包含很多种类似的形式,简洁且人性化。实现原理也比较简单,是通过“查询指定日期的下一个节假日”获取相关信息,解析后个性化制作提示信息,可以通过同样的方式编程进行自定义设置。
返回样例:
{ "status": "success", "message": "", "time": 1641195935, "data": { "info": { "date": "2021-12-30", "type": 0, "offwork": false, "name": "工作日", "wage": 1, "descr": "", "week": 4, "weekname": "周四" }, "chat": "今天是工作日, 加油!后天就是元旦啦!" } }
指定日期下一日的节假日信息及语料
与上一功能基本相同,只是“今天”会替换成“明天”。
怎么感觉和上面的功能重复了,我把指定日期设成“明天”不就行了?是的,没错,月萌API在处理接口时,为了保证接口的简单(参数少)易用(易理解不混淆),会尽可能地拆分功能,满足各类使用场景,即使这样会增加一些冗余性,根据实际业务场景忽略这些“多余”的功能就好啦。
下一个节假日信息及语料
参数 是否必填 说明 date 否 查询日期,格式yyyy-MM-dd, 如2022-01-20(2020年1月20日),默认为今日 week 否 Y/N,下一个节假日是否包含周末,默认不包含,只查询法定节假日 weekend 否 指定周末,默认为6,7表示周六和周日,可根据实际休息时间指定周几为周末,多个星期使用逗号分隔。 语料格式:
- 下一个节假日是元旦(2022-01-01), 还有31天
返回示例:
{ "status": "success", "message": "", "time": 1641196776, "data": { "info": { "date": "2022-01-01", "type": 2, "offwork": true, "name": "元旦", "wage": 3, "descr": "元旦休假", "week": 6, "weekname": "周六" }, "chat": "下一个节假日是元旦(2022-01-01), 还有31天" } }
-
请求参数展开
请求 参数名 参数值 操作 - 返回结果
尚无返回结果
-
接口: 节假日API
节假日API接口,查询指定日期是否为节假日,查询下一个周末或法定节假日,查询下一个工作日,批量查询节假日信息
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接口api_id: 154, apicode: holiday接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点访问地址
注: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apicode=holiday&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apicode=holiday&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: holiday keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 查询日期,格式yyyy-MM-dd, 如2022-01-20(2020年1月20日),默认为今日展开weekend否 指定周末,默认为6,7表示周六和周日,可根据实际休息时间指定周几为周末,多个星期使用逗号分隔。展开6,7注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
响应规范 类型 描述 必要字段 可选字段 success 一切正常,并且(通常是)返回了一些数据 status, data, time error 处理请求时出错,例如:一个异常被抛出 status, code, message, time 系统参数 必含 类型 长度 Json Path 描述 status 是 字符串 10 $.status 状态, success/error code 否 字符串 9 $.code 错误码, 仅 error 状态下有效 message 否 字符串 300 $.message 错误信息, 仅 error 状态下有效 time 是 时间戳 $.time 响应时间戳 接口参数 必含 类型 长度 Json Path 描述 data type是 数字 $.data[*].type 日期类型,0/1/2/3, 0表示工作日,1表示周末,2表示节假日,3表示调班展开date是 字符串 $.data[*].date 查询的日期offwork是 字符串 $.data[*].offwork true/false, 是否休息name是 字符串 $.data[*].name 日期名称,如工作日、周末、节假日、调班展开wage是 字符串 $.data[*].wage 工资倍数,1/2/3,工作日为1倍,周末为2倍(或调休,根据公司规定执行),节假日3倍展开descr是 字符串 $.data[*].descr 节假日描述,工作日、周末此字段为空白展开week是 数字 $.data[*].week 周几,1/2/3/4/5/6/7,周一至周日展开weekname是 字符串 $.data[*].weekname 周几中文,周一、周二、周三、周四、周五、周六、周日展开注: 使用上方调试工具, 可直接查看返回数据结构相关资源
示例代码: 节假日API接口C#示例+ 资源文件: MoonApiData_holiday_154_v1.0_csharp.rar 示例代码: 节假日API接口java示例+ 资源文件: MoonApiData_holiday_154_v1.0_java.rar 示例代码: 节假日API接口nodejs示例+ 资源文件: MoonApiData_holiday_154_v1.0_nodejs.rar 示例代码: 节假日API接口php示例+ 资源文件: MoonApiData_holiday_154_v1.0_php.rar 示例代码: 节假日API接口python示例+ 资源文件: MoonApiData_holiday_154_v1.0_python.rar -
接入点: 查询指定日期区间段节假日信息
批量查询指定日期区间段节假日信息,可以指定任意起始、结束时间进行查询,将返回该区间内所有日期的节假日信息,包含工作日、周末、节假日、调班
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 155, apicode: holidaybatch, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=155&apicode=holidaybatch&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/155?apicode=holidaybatch&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=155&apicode=holidaybatch&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/155?apicode=holidaybatch&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 155 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: holidaybatch keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 start是 指定日期区间开始日期,日期格式yyyy-MM-dd,如2022-01-20,表示2022年1月20日展开end是 指定日期区间段结束日期,格式yyyy-MM-dd,如2022-01-20表示2022年1月20日展开weekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
响应规范 类型 描述 必要字段 可选字段 success 一切正常,并且(通常是)返回了一些数据 status, data, time error 处理请求时出错,例如:一个异常被抛出 status, code, message, time 系统参数 必含 类型 长度 Json Path 描述 status 是 字符串 10 $.status 状态, success/error code 否 字符串 9 $.code 错误码, 仅 error 状态下有效 message 否 字符串 300 $.message 错误信息, 仅 error 状态下有效 time 是 时间戳 $.time 响应时间戳 接口参数 必含 类型 长度 Json Path 描述 data是 数组 $.data 查询日期的节假日信息对象数组,每个日期对应一个对象,对象具体内容与节假日API中返回参数data字段相同,包含date,type,offwork,name,wage,descr,week,weekname等字段展开注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源. -
接入点: 查询指定日期的下一个节假日
查询指定日期的下一个节假日(开始日期),默认查询日期为今日,支持指定是否包含周末,支持自定义周末
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 156, apicode: nextHoliday, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=156&apicode=nextHoliday&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/156?apicode=nextHoliday&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=156&apicode=nextHoliday&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/156?apicode=nextHoliday&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 156 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: nextHoliday keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 查询日期,默认为今日week否 Y/N,下一个节假日是否包含周末,默认不包含,只查询法定节假日展开Nweekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
此接入点无特殊返回参数, 与 节假日API 参数相同.注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源. -
接入点: 查询指定日期的下一个工作日
查询指定日期的下一个工作日(包含调班),支持自定义周末
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 157, apicode: nextWorkday, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=157&apicode=nextWorkday&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/157?apicode=nextWorkday&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=157&apicode=nextWorkday&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/157?apicode=nextWorkday&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 157 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: nextWorkday keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 指定日期,默认为今日weekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
此接入点无特殊返回参数, 与 节假日API 参数相同.注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源. -
接入点: 指定日期的节假日信息及语料
指定日期(默认今日)的节假日信息及供机器人播报的节假日信息文本语料,同时预报指定天数内(默认5天内)的放假信息(包含周末、节假日)
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 158, apicode: dayInfoRobot, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=158&apicode=dayInfoRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/158?apicode=dayInfoRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=158&apicode=dayInfoRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/158?apicode=dayInfoRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 158 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: dayInfoRobot keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 指定日期,默认为今日,格式yyyy-MM-dd,如2022-01-20,表示2022年1月20日展开weekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7forcast否 预报N天内的下一休息日,默认5天内,包含周末和节假日展开5注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
响应规范 类型 描述 必要字段 可选字段 success 一切正常,并且(通常是)返回了一些数据 status, data, time error 处理请求时出错,例如:一个异常被抛出 status, code, message, time 系统参数 必含 类型 长度 Json Path 描述 status 是 字符串 10 $.status 状态, success/error code 否 字符串 9 $.code 错误码, 仅 error 状态下有效 message 否 字符串 300 $.message 错误信息, 仅 error 状态下有效 time 是 时间戳 $.time 响应时间戳 接口参数 必含 类型 长度 Json Path 描述 data info是 对象 $.data.info 查询日期的节假日信息对象,具体内容与节假日API中返回参数data字段相同,包含date,type,offwork,name,wage,descr,week,weekname等字段展开chat是 字符串 $.data.chat 机器人播报的节假日信息文本语料,如:今天是劳动节,可以放松休息啦!展开注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源. -
接入点: 指定日期下一日的节假日信息及语料
指定日期下一日(默认明日)的节假日信息及供机器人播报的节假日信息文本语料,同时预报指定天数内(默认5天内)的放假信息(包含周末、节假日)
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 159, apicode: tomorrowRobot, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=159&apicode=tomorrowRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/159?apicode=tomorrowRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=159&apicode=tomorrowRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/159?apicode=tomorrowRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 159 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: tomorrowRobot keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 指定日期,默认为今日,格式yyyy-MM-dd,如2022-01-20,表示2022年1月20日展开weekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7forcast否 预报N天内的下一休息日,默认5天内,包含周末和节假日展开5注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
响应规范 类型 描述 必要字段 可选字段 success 一切正常,并且(通常是)返回了一些数据 status, data, time error 处理请求时出错,例如:一个异常被抛出 status, code, message, time 系统参数 必含 类型 长度 Json Path 描述 status 是 字符串 10 $.status 状态, success/error code 否 字符串 9 $.code 错误码, 仅 error 状态下有效 message 否 字符串 300 $.message 错误信息, 仅 error 状态下有效 time 是 时间戳 $.time 响应时间戳 接口参数 必含 类型 长度 Json Path 描述 data info是 对象 $.data.info 查询日期的节假日信息对象,具体内容与节假日API中返回参数data字段相同,包含date,type,offwork,name,wage,descr,week,weekname等字段展开chat是 字符串 $.data.chat 机器人播报的节假日信息文本语料,如:明天是劳动节,可以放松休息啦!展开注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源. -
接入点: 下一个节假日信息及语料
下一个节假日信息及供机器人播报的节假日信息文本语料,支持指定是否包含周末,支持自定义周末
接口文档看起来太麻烦?直接文末查看 demo,C#/Java/PHP/Python/NodeJs 下载即用!当前接入点apid: 160, apicode: nextHolidayRobot, 若使用API接口 (上层 节假日API) KeyID & KeyCode 访问单独接入点时, 需要使用此 apid 参数, 详见正文请求参数说明接 口 完成某功能的一个或一组API
接入点 接口下能完成某个子功能的子API, 一个接口可包含多个接入点接口访问接入点地址:
注1: 仅当订阅方案为 接口订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/154?apid=160&apicode=nextHolidayRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
接入点直接访问地址
注1: 仅当订阅方案为 接入点订阅 时有效注2: 不需替换 KEY_ID 和 KEY_CODE, 调试工具会自动使用测试参数http://api.moonapi.com/160?apicode=nextHolidayRobot&keyid=KEY_ID&sign=KEY_CODE&_t=1731236629
请求参数
http://api.moonapi.com/154?apid=160&apicode=nextHolidayRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
http://api.moonapi.com/160?apicode=nextHolidayRobot&keyid=KEY_ID&sign=KEY_CODE&_t=
注: 参数名小写, 请求方法默认支持 GET/POST, 系统参数需组装为请求 URL, 其余参数未特别说明的,均可同时支持 GET/POST系统参数 必填 长度 描述 默认值 api_id 是 API接口 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 154 apid 是 Access Point 接入点 ID 编号, 注:请求 URL 中已包含,不需单独设置 当前ID: 160 apicode 否 30 编码, 仅用于助记,表示接口/接入点名称,不会实际使用,可不传 当前: nextHolidayRobot keyid 是 Key Id 分配的Key Id sign 是 24/32/40 API密钥/API签名, API验证支持两种方式认证, 认证方式一为简单签名模式, 直接将 sign 设置为 Key Code 即可, 认证方式二为 md5/hmac 签名认证, 将除 sign 字段的所有其它参数与其值组合后排序连接后加密签名, 设置 sign 为签名字符串, 并设置 keyid 为分配的 Key Id, 更多签名详情请参考月萌API接口签名规则及下方示例代码展开分配的Key Code fields 否 1000 附加字段列表, 返回数据默认仅返回必含字段, 若需其余可选字段, 需在请求时设置此参数, 多个可选字段之间用逗号分隔 _t 否 随机数或时间戳, 避免访问缓存结果 时间戳 接口参数 必填 长度 描述 默认值 date否 查询日期,默认为今日week否 Y/N,下一个节假日是否包含周末,默认不包含,只查询法定节假日展开Nweekend否 指定周末为星期几,默认6,7表示周末为周六和周日,根据自定义每周休息时间进行设置展开6,7注: 非必填的参数(有默认值),在构造请求 URL 时不填即可,demo 中为了演示多种情况可能包含了测试值,根据实际需要删除即可,此时将使用默认值返回参数
响应规范 类型 描述 必要字段 可选字段 success 一切正常,并且(通常是)返回了一些数据 status, data, time error 处理请求时出错,例如:一个异常被抛出 status, code, message, time 系统参数 必含 类型 长度 Json Path 描述 status 是 字符串 10 $.status 状态, success/error code 否 字符串 9 $.code 错误码, 仅 error 状态下有效 message 否 字符串 300 $.message 错误信息, 仅 error 状态下有效 time 是 时间戳 $.time 响应时间戳 接口参数 必含 类型 长度 Json Path 描述 data info是 对象 $.data.info 查询日期的节假日信息对象,具体内容与节假日API中返回参数data字段相同,包含date,type,offwork,name,wage,descr,week,weekname等字段展开chat否 字符串 $.data.chat 机器人播报的节假日信息文本语料,如:今天是劳动节,可以放松休息啦!展开注: 使用上方调试工具, 可直接查看返回数据结构相关资源
此接入点无资源文件, 请参考 节假日API 处资源.
- 订阅类型
-
共享
共享版
¥0/ 月
个人、小团队首选
共享免费充足调用配额无限制重复订阅每日限 10000 次调用每秒限 1 次调用限 1 个IP同时调用延迟 01秒 更新推荐众筹版
¥10/ 月
个人、小团队推荐
众筹版服务器支持批量检测接口技术支持每日不限调用次数每秒限 1 次调用限 1 个IP同时调用延迟 01秒 更新加强版
¥30/ 月
小团队推荐
加强版服务器支持不限量调用技术支持每日不限调用次数每秒限 3 次调用限 3 个IP同时调用实时更新
- 订阅方案
-
当前订阅方案包含接入点:当前订阅方案未包含接入点:
- 订阅数量
-
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 1年
- 1月32-1-2635200
- 2月32-2-5270400
- 3月32-3-7905600
- 4月32-4-10540800
- 5月32-5-13176000
- 6月32-6-15811200
- 7月32-7-18446400
- 8月32-8-21081600
- 9月32-9-23716800
- 10月32-10-26352000
- 11月32-11-28987200
- 1年32-12-31622400
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 1年
- 2年
- 3年
- 5年
- 10年
- 1月33-1-2635200
- 2月33-2-5270400
- 3月33-3-7905600
- 4月33-4-10540800
- 5月33-5-13176000
- 6月33-6-15811200
- 7月33-7-18446400
- 8月33-8-21081600
- 9月33-9-23716800
- 10月33-10-26352000
- 11月33-11-28987200
- 1年33-12-31622400
- 2年33-24-63244800
- 3年33-36-94867200
- 5年33-60-158112000
- 10年33-120-316224000
- 1月
- 2月
- 3月
- 4月
- 5月
- 6月
- 7月
- 8月
- 9月
- 10月
- 11月
- 1年
- 2年
- 3年
- 5年
- 10年
- 1月34-1-2635200
- 2月34-2-5270400
- 3月34-3-7905600
- 4月34-4-10540800
- 5月34-5-13176000
- 6月34-6-15811200
- 7月34-7-18446400
- 8月34-8-21081600
- 9月34-9-23716800
- 10月34-10-26352000
- 11月34-11-28987200
- 1年34-12-31622400
- 2年34-24-63244800
- 3年34-36-94867200
- 5年34-60-158112000
- 10年34-120-316224000
错误码 | 错误信息 | 描述 |
---|---|---|
MNA-000000 | 成功 | |
MNA-000001 | 系统错误 | 系统错误,默认错误码,各类未知错误 |
MNA-000010 | 任务未开始 | 任务未开始,异步任务排队等待中 |
MNA-000011 | 任务未完成 | 任务未完成,异步任务排队执行中 |
MNA-000012 | 任务已删除 | 任务已删除,任务超时或被移除 |
MNA-000013 | 任务错误 | 任务错误,错误原因见message |
MNA-000100 ~ MNA-000600 | 状态错误 | MNA-000100 ~ MNA-000600对应Http Status Code, 如: MNA-000403表示HTTP/1.1 403 Forbidden资源不可用, MNA-000500表示HTTP/1.1 500 Internal Server Error服务器遇到了意料不到的情况等 |
错误码 | 错误信息 | 描述 |
---|---|---|
MNA-100009 | 参数错误 | 参数格式错误 |
MNA-100010 | 数据源错误 | 当前年份无节假日信息 |
技术支持
技术支持:Moonapi
- 服务QQ 暂无
- 服务QQ群 暂无
- 微信 暂无
- 联系邮箱 暂无
- 问题反馈 节假日API
最新反馈
点击 | 回复 | 主题 | 作者 | 最后回复 |
278 | 1 | [节假日API] 节假日接口报错了 | Moon_20230808103615236 | 2024-06-18 09:17:01 |
681 | 0 | [节假日API] 2023-09-29应该是工资倍数应该是3吧 | kirawinder | 2023-07-31 16:45:11 |
服务在线率99.5%以上, 服务遇到质量问题享受退款保障
如果当前服务无法满足您的需求,可以联系我们。我们评估需求通过后,提供定制化解决方案
服务使用期间可享受随时暂停(延期), 变更或退订服务, 注:退订时仅收取实际发生费用与手续费(手续费为订阅金额5%,主要包含因订阅产生的各类人工成本)
订阅方案可随时灵活升级, 仅补剩余服务期订阅方案差价
周一至周日 9:00-23:00技术在线服务
-
节假日工具
节假日API
共享节假日API接口,查询指定日期是否为节假日,查询下一个周末或法定节假日,查询下一个工作日,批量查询节假日信息
Moonapi 11051 1418700 -
微信消息推送
微信消息推送
共享微信推送消息API是基于企业微信消息发送接口, 将各类文本消息、文件消息、文本卡片消息、图文消息、markdown消息推送至个人微信,企业微信的微信消息推送解决方案
Moonapi 5503 24000 -
现货黄金黄金价格黄金美元
现货黄金
共享黄金价格走势图,今日黄金价格走势图,黄金价格走势, 提供每日最新24小时黄金价格实时行情报价及今天的走势图分析,提供现在黄金期货,黄金首饰,黄金回收等近期资讯及新闻
MoonApi 4252 29600 -
古诗
古诗随机一首
共享随机古诗一首,体验诗仙李白的豪放飘逸,诗圣杜甫的沉郁顿挫,诗佛王维的诗中有画,诗魔白居易的晓畅通俗,诗豪刘禹锡的旷达沉雄,七绝圣手王昌龄的清畅雄浑,五言长城刘长卿的清旷淡雅,孟浩然的淡泊清逸,高适的慷慨悲壮,岑参的雄奇弘阔,李商隐的精工典丽,杜牧的俊爽清妙
Moonapi 5101 1258300