黄历查询-运势查询-国际法定节假日查询-API接口介绍

一个接口轻松搞定法定节假日、国际节日等信息！

每到节假日前夕，总会有不少人或者公司遇到同一个问题：

• 今天是不是法定节假日？
• 明天是什么节日？
• 今年端午节是哪一天？
• 某一天对应的国际节日是什么？
• 如何获取完整的全年节假日列表？

那么，有没有更简单的方法维护一套准确、完整的节假日数据？
答案当然是有的！！

戳这里

节假日列表接口有什么作用？

如果你的系统需要展示全年节假日，那么节假日列表接口就非常实用。
通过接口，可以快速获取指定年份的节假日数据。
开发者无需再手动整理全年日历，也不用担心遗漏重要节日。

请求参数

| 名称 | 类型|必须|

说明

|
| - | - |
| year | String | 否 | 需要查询的年份, 默认查询当年的节假日列表 |

例如可以实现：

• 展示全年节假日日历
• 节日专题页面
• 节日营销活动配置
• 节假日提醒功能
• 日历应用展示

对于需要制作节日运营页面的平台来说，提前获取完整节假日列表，可以大幅提高开发效率。

返回样例

{
  "code": 200, // 详见返回码说明 
  "msg": "成功",
  "taskNo": "526782409178028989145499", // 请求号
  "charge": true,  // 计费标识
  "data": {
    "count": 12, //  一年的节假日数量
    "items": [ // 一年的节假日列表
      {
        "begin": "20181230", // 节假日的开始时间
        "end": "20190101",  // 节假日的结束时间
        "holiday": "元旦",  // 节假日名称
        "holiday_remark": "放假3天，其中2018年12月30日至2019年1月1日放假调休，2018年12月29日（周六）正常上班", // 节假日描述
        "inverse_days": [ // 调修日列表，只有2021年之后的数据有值
          "20181229"
        ]
      }
    ]
  }
}

节假日详情接口能查询哪些内容？

除了获取节假日列表之外，更常用的是节假日详情查询。
只需要传入日期，即可查询当天对应的节假日信息。
不仅能够查询法定节假日，还可以获取对应的世界国际日等相关信息。

请求参数

| 名称 | 类型|必须|

说明

|
| - | - |
| date | String | 否 | 查询的日期，默认当天 |
| needDesc | String | 否 | 是否需要返回当日公众日、国际日和
我国传统节日的简介，1-返回，默认不返回 |

例如可以实现：

• 查询今天是什么节日
• 查询指定日期节日信息
• 国际节日展示
• 节日介绍

返回样例

{
  "code": 200, // 详见返回码说明
  "msg": "成功",
  "taskNo": "526782409178028989145499",  // 请求号
  "charge": true, // 计费标识
  "data": {
    "day": "20210501", // 查询的日期
    "holiday": "劳动节",  // 节日名称，工作日时显示“无”，周末时显示“周末”，节日时显示节日名称
    "type": "3", // 1为工作日，2为周末，3为节假日
    "begin": "20210501", // 节日或周末开始时间，如果是工作日，此字段为空串
    "end": "20210503", // 节日或周末结束时间，如果是工作日，此字段为空串
    "holiday_remark": "5月1日—5月3日放假，共3天，5月8日（星期六）要上班。", // 节日备注
    "weekDay": 6, // 星期几的数字
    "cn": "周六", // 英期几的中文名
    "en": "Saturday", // 星期几的英文名
    "h": [  // 如果当日没有节日则返回空List，该字段需要请求参数中needDesc上传1才返回
      {
        "name": "世界文化发展日", // 节日名称
        "genus": "public", // 节日种类，public表示公众日或国际日，traditional表示传统节日
        "day": "0521", // 节日公历日期
        "lunaDay": "", // 节日的农历日期
        "info": "", // 节日的简介
        "origin": "" // 节日的起源
      }
    ]
  }
}

一个接口，可以应用到哪些行业？

• 在线旅游平台
• 酒店预订系统
• 火车票、机票预订
• 企业OA办公系统
• 日程管理工具
• 企业ERP系统
• 电商促销平台
• 教育考试平台
• 智能提醒应用

为什么越来越多开发者选择接口获取节假日信息？

对于需要构建日历、提醒、营销、预约、排班、旅游预订等功能的系统来说，这类接口能够有效减少数据维护成本，提高开发效率，同时也能为用户提供更加智能、更加丰富的产品体验。
相比之下，接口方式具有不少优势：

• 节假日数据获取更加方便
• 节日信息查询更加灵活
• 减少人工维护成本
• 方便快速接入现有系统
• 可用于多种业务场景
• 提高开发效率