OpenHolidays API：公休日与学校假期

OpenHolidays 官方入门页提供按国家、地区和日期查询公休日与学校假期的 REST API，可返回 JSON 或 iCal；每次日期区间最长三年。支持范围以文档列出的国家为准，认证、费用及限流未知，尚未调用。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-71e487cd79fca5366c71a9d4
Card version: 2
Updated: 2026-10-24T17:50:55.3981018+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

该 Open Data 项目收集公休日及学校假期，提供国家、语言、地区和特殊分组元数据，以便筛选假期。文档包含完整 HTTP GET 示例；不同国家支持的数据种类和范围不同，不能推断全球覆盖。

Inputs

PublicHolidays / SchoolHolidays 使用 countryIsoCode、validFrom、validTo，可选 languageIsoCode；学校假期还可选 subdivisionCode。
国家码使用 ISO 3166-1，语言码使用 ISO 639-1；地区码依据 ISO 3166-2 与 HASC。
可先读 /Countries、/Languages、/Subdivisions?countryIsoCode=DE、/groups?countryIsoCode=BE 等元数据端点。

Outputs

假期数据可按 Accept 返回 JSON 或 iCal，可选择名称语言。
国家、语言、地区及分组端点提供过滤元数据；本页未给完整 JSON 字段 schema。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "unknown",
    "notes": "\u6240\u6355\u83B7\u7684\u5165\u95E8\u9875\u6CA1\u6709\u660E\u786E\u8BA4\u8BC1\u8981\u6C42\uFF1B\u793A\u4F8B\u672A\u5217\u51ED\u636E\uFF0C\u4E0D\u636E\u6B64\u4F5C\u6C38\u4E45\u514D\u8BA4\u8BC1\u627F\u8BFA\u3002"
  },
  "command": null,
  "entry_url": "https://openholidaysapi.org/PublicHolidays",
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "headers": {
      "Accept": "text/json"
    },
    "method": "GET",
    "notes": "\u5B98\u65B9\u5386\u53F2\u793A\u4F8B\uFF0C\u4EC5\u5C55\u793A\u5951\u7EA6\uFF0C\u672A\u8BF7\u6C42\u4E5F\u4E0D\u4EE3\u8868\u5F53\u524D\u5047\u671F\u8986\u76D6\u3002",
    "query": {
      "countryIsoCode": "CH",
      "languageIsoCode": "DE",
      "validFrom": "2022-01-01",
      "validTo": "2022-06-30"
    },
    "url": "https://openholidaysapi.org/PublicHolidays"
  },
  "requirements": [
    "\u9009\u62E9\u53D7\u652F\u6301\u7684\u56FD\u5BB6\u4E0E\u65E5\u671F\u8303\u56F4\uFF0C\u5355\u6B21\u533A\u95F4\u4E0D\u8D85\u8FC7\u4E09\u5E74\u3002",
    "Accept: text/json \u8FD4\u56DE JSON\uFF1BAccept: text/calendar \u8BF7\u6C42 iCal\u3002",
    "\u5B66\u6821\u5047\u671F\u53EF\u6309\u76F8\u5173 subdivision \u6216 group \u7B5B\u9009\uFF0C\u5177\u4F53\u56FD\u5BB6\u652F\u6301\u60C5\u51B5\u4E0D\u540C\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u9875\u9762\u79F0 Open Data / open REST API\uFF0C\u4F46\u672A\u660E\u786E\u6258\u7BA1\u63A5\u53E3\u8D39\u7528\u6216\u514D\u8D39\u989D\u5EA6\uFF0C\u4E0D\u7531\u5F00\u653E\u6570\u636E\u79F0\u8C13\u63A8\u65AD\u514D\u8D39\u3002",
  "source_url": "https://www.openholidaysapi.org/en/"
}

{
  "location": "provider_server",
  "notes": "\u67E5\u8BE2\u56FD\u5BB6\u3001\u65E5\u671F\u3001\u8BED\u8A00\u548C\u5730\u533A\u53C2\u6570\u4F1A\u9001\u81F3\u670D\u52A1\u7AEF\u3002\u6587\u6863\u4EC5\u94FE\u63A5 Privacy\uFF0C\u672A\u5305\u542B\u6B63\u6587\uFF0C\u672C\u5361\u4E0D\u63A8\u65AD\u65E5\u5FD7\u4FDD\u7559\uFF1B\u672C\u6B21\u672A\u8BF7\u6C42\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

单次公休日及学校假期查询的日期区间不能超过三年。
仅覆盖文档列明的国家及数据类型；部分国家只有公休日，地区与学校分组也不是每国均有。
这是假期数据项目的入门说明，完整返回字段、错误契约、认证、费用、限流及配额未在本附件明确。

Unknowns

认证要求、费用、请求速率、配额、SLA 和日志保留未知。
完整响应 schema、实际时段覆盖和假期数据准确性未测试。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:50:09.7968187\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://www.openholidaysapi.org/en/"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": "ST\u00DCBER SYSTEMS GmbH",
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "physical",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u67E5\u8BE2\u56FD\u5BB6\u3001\u65E5\u671F\u3001\u8BED\u8A00\u548C\u5730\u533A\u53C2\u6570\u4F1A\u9001\u81F3\u670D\u52A1\u7AEF\u3002\u6587\u6863\u4EC5\u94FE\u63A5 Privacy\uFF0C\u672A\u5305\u542B\u6B63\u6587\uFF0C\u672C\u5361\u4E0D\u63A8\u65AD\u65E5\u5FD7\u4FDD\u7559\uFF1B\u672C\u6B21\u672A\u8BF7\u6C42\u3002"
  },
  "description": "\u8BE5 Open Data \u9879\u76EE\u6536\u96C6\u516C\u4F11\u65E5\u53CA\u5B66\u6821\u5047\u671F\uFF0C\u63D0\u4F9B\u56FD\u5BB6\u3001\u8BED\u8A00\u3001\u5730\u533A\u548C\u7279\u6B8A\u5206\u7EC4\u5143\u6570\u636E\uFF0C\u4EE5\u4FBF\u7B5B\u9009\u5047\u671F\u3002\u6587\u6863\u5305\u542B\u5B8C\u6574 HTTP GET \u793A\u4F8B\uFF1B\u4E0D\u540C\u56FD\u5BB6\u652F\u6301\u7684\u6570\u636E\u79CD\u7C7B\u548C\u8303\u56F4\u4E0D\u540C\uFF0C\u4E0D\u80FD\u63A8\u65AD\u5168\u7403\u8986\u76D6\u3002",
  "inputs": [
    "PublicHolidays / SchoolHolidays \u4F7F\u7528 countryIsoCode\u3001validFrom\u3001validTo\uFF0C\u53EF\u9009 languageIsoCode\uFF1B\u5B66\u6821\u5047\u671F\u8FD8\u53EF\u9009 subdivisionCode\u3002",
    "\u56FD\u5BB6\u7801\u4F7F\u7528 ISO 3166-1\uFF0C\u8BED\u8A00\u7801\u4F7F\u7528 ISO 639-1\uFF1B\u5730\u533A\u7801\u4F9D\u636E ISO 3166-2 \u4E0E HASC\u3002",
    "\u53EF\u5148\u8BFB /Countries\u3001/Languages\u3001/Subdivisions?countryIsoCode=DE\u3001/groups?countryIsoCode=BE \u7B49\u5143\u6570\u636E\u7AEF\u70B9\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "unknown",
      "notes": "\u6240\u6355\u83B7\u7684\u5165\u95E8\u9875\u6CA1\u6709\u660E\u786E\u8BA4\u8BC1\u8981\u6C42\uFF1B\u793A\u4F8B\u672A\u5217\u51ED\u636E\uFF0C\u4E0D\u636E\u6B64\u4F5C\u6C38\u4E45\u514D\u8BA4\u8BC1\u627F\u8BFA\u3002"
    },
    "command": null,
    "entry_url": "https://openholidaysapi.org/PublicHolidays",
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "headers": {
        "Accept": "text/json"
      },
      "method": "GET",
      "notes": "\u5B98\u65B9\u5386\u53F2\u793A\u4F8B\uFF0C\u4EC5\u5C55\u793A\u5951\u7EA6\uFF0C\u672A\u8BF7\u6C42\u4E5F\u4E0D\u4EE3\u8868\u5F53\u524D\u5047\u671F\u8986\u76D6\u3002",
      "query": {
        "countryIsoCode": "CH",
        "languageIsoCode": "DE",
        "validFrom": "2022-01-01",
        "validTo": "2022-06-30"
      },
      "url": "https://openholidaysapi.org/PublicHolidays"
    },
    "requirements": [
      "\u9009\u62E9\u53D7\u652F\u6301\u7684\u56FD\u5BB6\u4E0E\u65E5\u671F\u8303\u56F4\uFF0C\u5355\u6B21\u533A\u95F4\u4E0D\u8D85\u8FC7\u4E09\u5E74\u3002",
      "Accept: text/json \u8FD4\u56DE JSON\uFF1BAccept: text/calendar \u8BF7\u6C42 iCal\u3002",
      "\u5B66\u6821\u5047\u671F\u53EF\u6309\u76F8\u5173 subdivision \u6216 group \u7B5B\u9009\uFF0C\u5177\u4F53\u56FD\u5BB6\u652F\u6301\u60C5\u51B5\u4E0D\u540C\u3002"
    ]
  },
  "limitations": [
    "\u5355\u6B21\u516C\u4F11\u65E5\u53CA\u5B66\u6821\u5047\u671F\u67E5\u8BE2\u7684\u65E5\u671F\u533A\u95F4\u4E0D\u80FD\u8D85\u8FC7\u4E09\u5E74\u3002",
    "\u4EC5\u8986\u76D6\u6587\u6863\u5217\u660E\u7684\u56FD\u5BB6\u53CA\u6570\u636E\u7C7B\u578B\uFF1B\u90E8\u5206\u56FD\u5BB6\u53EA\u6709\u516C\u4F11\u65E5\uFF0C\u5730\u533A\u4E0E\u5B66\u6821\u5206\u7EC4\u4E5F\u4E0D\u662F\u6BCF\u56FD\u5747\u6709\u3002",
    "\u8FD9\u662F\u5047\u671F\u6570\u636E\u9879\u76EE\u7684\u5165\u95E8\u8BF4\u660E\uFF0C\u5B8C\u6574\u8FD4\u56DE\u5B57\u6BB5\u3001\u9519\u8BEF\u5951\u7EA6\u3001\u8BA4\u8BC1\u3001\u8D39\u7528\u3001\u9650\u6D41\u53CA\u914D\u989D\u672A\u5728\u672C\u9644\u4EF6\u660E\u786E\u3002"
  ],
  "outputs": [
    "\u5047\u671F\u6570\u636E\u53EF\u6309 Accept \u8FD4\u56DE JSON \u6216 iCal\uFF0C\u53EF\u9009\u62E9\u540D\u79F0\u8BED\u8A00\u3002",
    "\u56FD\u5BB6\u3001\u8BED\u8A00\u3001\u5730\u533A\u53CA\u5206\u7EC4\u7AEF\u70B9\u63D0\u4F9B\u8FC7\u6EE4\u5143\u6570\u636E\uFF1B\u672C\u9875\u672A\u7ED9\u5B8C\u6574 JSON \u5B57\u6BB5 schema\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u9875\u9762\u79F0 Open Data / open REST API\uFF0C\u4F46\u672A\u660E\u786E\u6258\u7BA1\u63A5\u53E3\u8D39\u7528\u6216\u514D\u8D39\u989D\u5EA6\uFF0C\u4E0D\u7531\u5F00\u653E\u6570\u636E\u79F0\u8C13\u63A8\u65AD\u514D\u8D39\u3002",
    "source_url": "https://www.openholidaysapi.org/en/"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-25T01:50:09.7968187\u002B08:00",
      "title": "OpenHolidays API",
      "url": "https://www.openholidaysapi.org/en/"
    }
  ],
  "summary": "OpenHolidays \u5B98\u65B9\u5165\u95E8\u9875\u63D0\u4F9B\u6309\u56FD\u5BB6\u3001\u5730\u533A\u548C\u65E5\u671F\u67E5\u8BE2\u516C\u4F11\u65E5\u4E0E\u5B66\u6821\u5047\u671F\u7684 REST API\uFF0C\u53EF\u8FD4\u56DE JSON \u6216 iCal\uFF1B\u6BCF\u6B21\u65E5\u671F\u533A\u95F4\u6700\u957F\u4E09\u5E74\u3002\u652F\u6301\u8303\u56F4\u4EE5\u6587\u6863\u5217\u51FA\u7684\u56FD\u5BB6\u4E3A\u51C6\uFF0C\u8BA4\u8BC1\u3001\u8D39\u7528\u53CA\u9650\u6D41\u672A\u77E5\uFF0C\u5C1A\u672A\u8C03\u7528\u3002",
  "tags": [
    "http_api",
    "documentation_only",
    "public_holidays",
    "school_holidays"
  ],
  "terms_url": null,
  "title": "OpenHolidays API\uFF1A\u516C\u4F11\u65E5\u4E0E\u5B66\u6821\u5047\u671F",
  "unknowns": [
    "\u8BA4\u8BC1\u8981\u6C42\u3001\u8D39\u7528\u3001\u8BF7\u6C42\u901F\u7387\u3001\u914D\u989D\u3001SLA \u548C\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002",
    "\u5B8C\u6574\u54CD\u5E94 schema\u3001\u5B9E\u9645\u65F6\u6BB5\u8986\u76D6\u548C\u5047\u671F\u6570\u636E\u51C6\u786E\u6027\u672A\u6D4B\u8BD5\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:50:09.7968187\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://www.openholidaysapi.org/en/"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-71e487cd79fca5366c71a9d4",
  "version": 2,
  "source_url": "https://www.openholidaysapi.org/en/",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://www.openholidaysapi.org/en/",
    "final_url": "https://www.openholidaysapi.org/en/",
    "status_code": 200,
    "title": "OpenHolidays API",
    "description": null,
    "checked_at": "2026-10-24T17:50:09.7968187\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:50:12.5657640\u002B00:00",
  "updated_at": "2026-10-24T17:50:55.3981018\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-71e487cd79fca5366c71a9d4?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-71e487cd79fca5366c71a9d4?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u516C\u5171\u65E5\u5386\uFF0F\u5404\u56FD\u516C\u4F11\u65E5\u4E0E\u5B66\u6821\u5047\u671F\u6570\u636E",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-a4cd7f13d3488183e74ae499668b7535",
        "source_url": "https://www.openholidaysapi.org/en/",
        "content_sha256": "d2989b0d9cd5806a0c0f4a6cb8dd5018a919c486abba8285247a2d2ea551bca8",
        "decoded_bytes": 39005,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:50:09.7968187\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "d2989b0d9cd5806a0c0f4a6cb8dd5018a919c486abba8285247a2d2ea551bca8",
        "text_utf8_bytes": 39005,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-71e487cd79fca5366c71a9d4/materials/material-a4cd7f13d3488183e74ae499668b7535?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-bf3c312cc8604a4daf8077f116b0d2e0",
    "reason": "\u4F9D\u636E\u672C\u6279 OpenHolidays \u5165\u95E8\u6B63\u6587\u7684\u5B8C\u6574 HTTP \u793A\u4F8B\u3001\u8FC7\u6EE4\u53C2\u6570\u3001JSON/iCal \u683C\u5F0F\u548C\u4E09\u5E74\u533A\u95F4\u9650\u5236\u6574\u7406\u5E76\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u5F00\u653E\u6570\u636E\u4E0D\u81EA\u52A8\u7B49\u4E8E\u514D\u8D39/\u514D\u8BA4\u8BC1\uFF1B\u7F3A\u5C11\u7684\u8D39\u7528\u3001\u8BA4\u8BC1\u548C\u914D\u989D\u5747\u4FDD\u7559\u672A\u77E5\uFF0C\u4FDD\u6301 documentation_only\u3002",
    "source_urls": [
      "https://www.openholidaysapi.org/en/"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-71e487cd79fca5366c71a9d4",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-71e487cd79fca5366c71a9d4?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-71e487cd79fca5366c71a9d4?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure