Loading / 加载中…
Loading / 加载中…
实用工具与 AI 数据
按两位国家代码查询的假日数据,另有一个操作列出支持的国家代码。可以获取某一年的假日、判断某个日期是否为工作日、统计两个日期之间的工作日数量、列出参考日期之后尚未到来的假日,或查找长周末及建议的桥接日。可选输入允许调用方重新定义周末、选择哪一种假日类型算作休息日,并按地区缩小范围。
正在核对当前可用状态与已批准价格…
JSON 输入,结构化响应。公共网关端点统一使用 POST。
无需任何输入,返回支持的国家代码及名称。
POST /api/v1/holidays/holidays-countries使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {}
}列出某个国家在 1900 到 2200 之间某一年的假日。
POST /api/v1/holidays/holidays-holidays使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {
"country": "US",
"year": 2026
}
}判断某个日期在某国是否为工作日,并随结果返回判断依据。
POST /api/v1/holidays/holidays-is-workday使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {
"country": "US",
"date": "2026-01-01"
}
}返回某一年的长周末窗口,并为每个窗口标注是否需要桥接日。
POST /api/v1/holidays/holidays-long-weekends使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {
"country": "US",
"year": 2026
}
}返回今天或你指定的参考日期之后的假日,并为每个假日给出剩余天数。
POST /api/v1/holidays/holidays-next-holidays使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {
"country": "US"
}
}返回起止日期(含两端)之间的工作日、周末日与假日天数。
POST /api/v1/holidays/holidays-workday-count使用 JSON 对象,按文档将参数放入 path、query、headers 和 body,省略未使用的位置。input.headers 是受结构校验的数据,不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null;省略与 null 含义不同。
{
"body": {
"country": "US",
"end": "2026-01-31",
"start": "2026-01-01"
}
}POST /api/v1/<project>/<action>,并携带 x-api-key、Content-Type: application/json 和必需的 Idempotency-Key。data 是操作的结果。单次请求不行。body.types 只能取 Public、Bank、School、Authorities、Optional、Observance 中的一个值,写法须与列出的完全一致;省略时只有 Public 算作休息日。若要把多种类型都算作休息日,可按类型分别请求并按日期合并结果:仅当每个按类型的响应都判定为工作日时,该日期才是工作日。不要把多次 holidays-workday-count 请求的计数直接相加。区间计数不返回逐日的工作日结果,因此合并计数需要用 holidays-is-workday 逐日获取结果(每个日期、每种类型各一次请求),或由你自行计算。
年度假日列表与长周末查找接受 1900 到 2200 之间的整数年份;契约会拒绝其他取值。
默认以周六和周日为周末,EG 与 BD 则为周五和周六;可以用 body.weekend 按星期名称覆盖。