下一个公共假日

查找指定当地公历日期当天或之后的一个公共假日。

请求

使用 Narwhal 密钥即可访问已发布的国家-年份数据。检查覆盖范围和作用域之后再请求日期。

GET /v1/calendars/holidays/{country}/next?from_date={from_date}

curl "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

参数

名称	类型	规则
`country`	字符串	必填路径值。一个受支持的大写 ISO 三字母代码，例如 IDN。
`from_date`	日期字符串	必填查询值，格式为 YYYY-MM-DD，年份范围为 1900 至 2200。不自动默认为今天。
`scope`	字符串	可选查询筛选条件：national_public、regional_public、bank、federal_government、central_government、collective_leave、public_sector 或 private_sector。省略此项可返回所有已发布类别。

没有细分地区筛选或分页。MCP 输入对象会拒绝额外字段。

说明性响应

{
  "country": "IDN",
  "from_date": "2026-08-01",
  "coverage": [
    {
      "scope": "national_public",
      "nationwide": true,
      "subdivision_codes": []
    },
    {
      "scope": "collective_leave",
      "nationwide": true,
      "subdivision_codes": []
    }
  ],
  "holiday": {
    "date": "2026-08-17",
    "name": "Independence Day",
    "local_name": "Hari Kemerdekaan",
    "subdivision_codes": [],
    "nationwide": true,
    "observed": null,
    "scope": "national_public"
  }
}

开始日期包含在内。接口先搜索当前年份，仅在必要时搜索下一年份。缺少必需覆盖范围时返回503。搜索不会超过2200年；在这个最大年份没有剩余事件时返回holiday: null。可以返回地区假日。多个事件同属最早日期时，稳定排序中的第一个胜出；使用日期端点获取全部事件。

共享假日字段。每个事件都明确标注适用于全国还是特定地区。

对应的 MCP 调用

发送经过身份验证的 POST /mcp 与 Accept: application/json, text/event-stream.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calendars_get_next_holiday",
    "arguments": {
      "country": "IDN",
      "from_date": "2026-08-01"
    }
  }
}

成功的结果包含 isError: false，相同的响应位于 structuredContent，以及序列化后的 JSON，位于 content[0].text。领域错误包含 isError: true.

错误与配额

无效输入返回 400；缺失或无效密钥返回 401；未挂载路由返回 404；汇率或配额耗尽返回 429；缺失、无效或已撤回的日历返回 503 calendar_coverage_unavailable.

每次成功调用消耗一次月度请求额度，与读取的事件数量或年份无关。错误不会消耗月度额度。共享错误详情.

所有日历操作 · 覆盖范围和解读