今天是纪念日

接口说明

查询当前日期对应的国内传统节日与国际主题日信息，返回纪念日名称、简介及类型，同时提供距今最近的下一个纪念日倒计时。适用于日历应用、提醒工具或内容平台展示日期文化背景。

调用地址

https://api.example.com/v1/festival.php

请求方式

GET、POST

鉴权说明

无需密钥。

请求参数

此接口无需传入任何参数，直接调用即可获取当日纪念日信息。

成功响应示例

{
  "current_date": "2026-09-07",
  "today_festivals": [
    {
      "name": "白露",
      "description": "白露太阳黄经165°，约在9月7日，《月令》载"露凝而白"。南方收清露制白露茶，北方"十样白"炖鸡补身，农业上华南晚稻抽穗、华北玉米收获。养生防"秋燥伤肺"，食梨、芝麻，添衣防"白露身不露"，谚语"白露秋分夜，一夜凉一夜"形象描绘气温速降。",
      "type": "中国传统"
    },
    {
      "name": "国际秃鹰日",
      "description": "关注食腐鸟类",
      "type": "国际主题日"
    }
  ],
  "next_festival": {
    "name": "国际扫盲日",
    "date": "2026-09-08",
    "days_away": 1,
    "description": "1965年联合国教科文组织将9月8日定为"国际扫盲日"，2025年主题"转型教育·扫盲与数字技能"。各国开展成人识字班、移动阅读APP推广，发布《全球扫盲报告》，强调功能性扫盲与数字素养并重，助力边缘群体获得就业与参与现代社会的机会。",
    "type": "国际主题日"
  }
}

响应字段说明

错误响应示例

{
  "code": 0,
  "msg": "请求成功",
  "errcode": 0
}

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

调用示例

终端 curl（bash）

curl -X GET "https://api.example.com/v1/festival.php"

PHP

// PHP 示例
$response = file_get_contents("https://api.example.com/v1/festival.php");
$data = json_decode($response, true);
print_r($data);

注意事项

1. 返回数据说明：响应中 today_festivals 数组可能为空（某些日期无预设纪念日），next_festival 字段必返回，其中 days_away 为 0 表示当天存在纪念日。

2. 数据用途：纪念日数据来源于公开历法与主题日数据库，仅供查询参考，不作为正式历史考证或学术依据。

3. 时区说明：返回的日期信息基于服务器所在时区（UTC），跨时区调用时需注意与本地日期的差异。

4. 网络要求：建议通过 HTTPS 调用本接口，以确保数据传输安全。

5. 频率控制：免费接口不设明确配额限制，但建议合理控制请求频率，避免短时间内高频调用。

6. 返回值更新：纪念日数据库可能随节假日编排规则调整而更新，重复调用同一日期可能因数据版本迭代返回略有差异的内容。