关于API: 此API检索特定国家庆祝的所有公共和非公共假期的列表。检查当前年份、未来年份和过去年份。支持全球195个国家。 什么是此API接收的以及您的API提供的(输入/输出)? 只需传递您选择的国家,选择年份,甚至您想要检查的月份和日期。您将收到假期的日期、名称(如果是公共假期)以及它将在一周的哪一天庆祝。 支持的国家列表: AD(安道尔) AE(阿拉伯联合酋长国) AG(安提瓜和巴布达) AI(安圭拉) AL(阿尔巴尼亚) AM(亚美尼亚) AO(安哥拉) AR(阿根廷) AS(美属萨摩亚) AT(奥地利) AU(澳大利亚) AW(阿鲁巴) AX(奥兰群岛) AZ(阿塞拜疆共和国) BA(波斯尼亚和黑塞哥维那) BB(巴巴多斯) BD(孟加拉人民共和国) BE(比利时) BF(布基纳法索) BG(保加利亚) BH(巴林王国) BI(布隆迪共和国) BJ(贝宁共和国) BL(圣巴泰勒米) BM(百慕大) BN(文莱达鲁萨兰国) BO(玻利维亚) BQ(加勒比荷兰) BR(巴西) BS(巴哈马) BW(博茨瓦纳) BY(白俄罗斯共和国) BZ(伯利兹) CA(加拿大) CC(科科斯(基林)群岛) CD(刚果民主共和国) CF(中非共和国) CG(刚果共和国) CH(瑞士) CI(象牙海岸共和国) CK(库克群岛) CL(智利) CM(喀麦隆) CN(中华人民共和国) CO(哥伦比亚) CR(哥斯达黎加) CU(古巴) CV(佛得角共和国) CW(库拉索) CX(圣诞岛) CY(塞浦路斯) CZ(捷克共和国) DE(德国) DJ(吉布提共和国) DK(丹麦) DM(多米尼克) DO(多米尼加共和国) DZ(阿尔及利亚人民民主共和国) EC(厄瓜多尔) EE(爱沙尼亚) EG(阿拉伯埃及共和国) EH(撒哈拉阿拉伯民主共和国) ER(厄立特里亚) ES(西班牙) ET(埃塞俄比亚) FI(芬兰) FJ(斐济) FO(法罗群岛) FR(法国) GA(加蓬) GB(英国) GD(格林纳达) GE(格鲁吉亚) GF(法属圭亚那) GG(根西岛) GH(加纳) GI(直布罗陀) GL(格林兰) GM(冈比亚) GN(几内亚) GP(瓜德罗普) GQ(赤道几内亚共和国) GR(希腊) GT(危地马拉) GU(关岛) GW(几内亚比绍) GY(圭亚那) HK(香港) HN(洪都拉斯) HR(克罗地亚) HT(海地) HU(匈牙利) IC(加那利群岛) ID(印度尼西亚) IE(爱尔兰) IL(以色列) IM(曼岛) IS(冰岛) IT(意大利) JE(泽西岛) JM(牙买加) JP(日本) KE(肯尼亚) KM(科摩罗联邦) KN(圣基茨和尼维斯) KR(韩国) KY(开曼群岛) LC(圣卢西亚) LI(列支敦士登) LR(利比里亚) LS(莱索托王国) LT(立陶宛) LU(卢森堡) LV(拉脱维亚) LY(利比亚国) MA(摩洛哥王国) MC(摩纳哥) MD(摩尔多瓦共和国) ME(黑山) MF(圣马丁) MG(马达加斯加共和国) MK(北马其顿共和国) ML(马里共和国) MQ(马提尼克) MR(毛里塔尼亚伊斯兰共和国) MS(蒙特塞拉特) MT(马耳他) MW(马拉维) MX(墨西哥) MY(马来西亚) MZ(莫桑比克) NA(纳米比亚) NC(新喀里多尼亚) NE(尼日尔共和国) NG(尼日利亚) NI(尼加拉瓜) NL(荷兰) NO(挪威) NZ(新西兰) PA(巴拿马) PE(秘鲁) PH(菲律宾) PL(波兰) PM(圣皮埃尔和密克隆) PR(波多黎各) PT(葡萄牙) PY(巴拉圭) RE(留尼汪) RO(罗马尼亚) RS(塞尔维亚共和国) RU(俄罗斯) RW(卢旺达) SC(塞舌尔) SD(苏丹共和国) SE(瑞典) SG(新加坡) SH(圣赫勒拿) SI(斯洛文尼亚共和国) SJ(斯瓦尔巴群岛和扬马延) SK(斯洛伐克共和国) SL(塞拉利昂) SM(圣马力诺) SN(塞内加尔共和国) SO(索马里联邦共和国) SR(苏里南) SS(南苏丹) ST(圣多美和普林西比) SV(萨尔瓦多) SX(圣马丁) SZ(斯威士兰) TC(特克斯和凯科斯群岛) TD(乍得共和国) TG(多哥共和国) TN(突尼斯共和国) TO(汤加) TR(土耳其) TT(特立尼达和多巴哥) TW(中华民国) TZ(坦桑尼亚) UA(乌克兰) UG(乌干达) US(美利坚合众国) UY(乌拉圭) VA(梵蒂冈城国) VC(圣文森特和格林纳丁斯) VE(委内瑞拉) VG(英属维尔京群岛) VI(美属维尔京群岛) VN(越南社会主义共和国) VU(瓦努阿图共和国) XK(科索沃共和国) YT(马约特) ZA(南非) ZM(赞比亚) ZW(津巴布韦) 此API的最常见用例是什么? 此API非常适合那些希望跟踪其所需国家的任何假期的人。您将能够检测到年份中有多少个工作日,并根据该信息做出决策。 如果您是一家旅行社,并希望根据特定假期提供特别优惠,可以使用此API来实现。 确定假期将在哪一天举行,以便您知道这一天是否是工作日或周末。 您的计划是否有任何限制? 除了每月的API调用次数外: 免费计划:每秒1次请求 基础计划:每秒100次请求
要使用此端点,只需运行它,您将获得所有可用的国家。
{"message":"Available Countries","total":233,"countriesAvailable":["afghanistan","albania","algeria","american-samoa","andorra","angola","anguilla","antigua-and-barbuda","argentina","armenia","aruba","australia","austria","azerbaijan","bahrain","bangladesh","barbados","belarus","belgium","belize","benin","bermuda","bhutan","bolivia","bosnia","botswana","brazil","british-virgin-islands","brunei","bulgaria","burkina-faso","burundi","cape-verde","cambodia","cameroon","canada","cayman-islands","central-african-republic","chad","chile","china","colombia","comores","republic-of-the-congo","dr-congo","cook-islands","costa-rica","ivory-coast","croatia","cuba","curacao","cyprus","czech","denmark","djibouti","dominica","dominican-republic","timor-leste","ecuador","egypt","el-salvador","guineaecuatorial","eritrea","estonia","eswatini","ethiopia","falkland-islands","faroe-islands","fiji","finland","france","french-guiana","french-polynesia","gabon","gambia","georgia","germany","ghana","gibraltar","greece","greenland","grenada","guadeloupe","guam","guatemala","guernsey","guinea","guinea-bissau","guyana","haiti","honduras","hong-kong","hungary","iceland","india","indonesia","iran","iraq","ireland","isle-of-man","israel","italy","jamaica","japan","jersey","jordan","kazakhstan","kenya","kiribati","kosovo","kuwait","kyrgyzstan","laos","latvia","lebanon","lesotho","liberia","libya","liechtenstein","lithuania","luxembourg","macau","madagascar","malawi","malaysia","maldives","mali","malta","marshall-islands","martinique","mauritania","mauritius","mayotte","mexico","micronesia","moldova","monaco","mongolia","montenegro","montserrat","morocco","mozambique","myanmar","namibia","nauru","nepal","netherlands","new-caledonia","new-zealand","nicaragua","niger","nigeria","norfolk-island","north-korea","macedonia","northern-mariana-islands","norway","oman","pakistan","palau","panama","papua-new-guinea","paraguay","peru","philippines","poland","portugal","puerto-rico","qatar","reunion","romania","russia","rwanda","saint-helena","saint-kitts-and-nevis","saint-lucia","saint-martin","saint-pierre-and-miquelon","saint-vincent-and-the-grenadines","samoa","san-marino","sao-tome-and-principe","saudi-arabia","senegal","serbia","seychelles","sierra-leone","singapore","sint-maarten","slovakia","slovenia","solomon-islands","somalia","south-africa","south-korea","south-sudan","spain","sri-lanka","saint-barthelemy","sudan","suriname","sweden","switzerland","syria","taiwan","tajikistan","tanzania","thailand","bahamas","togo","tonga","trinidad","tunisia","turkey","turkmenistan","turks-and-caicos-islands","tuvalu","uganda","ukraine","united-arab-emirates","uk","us","uruguay","united-states-virgin-islands","uzbekistan","vanuatu","vatican-city-state","venezuela","vietnam","wallis-and-futuna","yemen","zambia","zimbabwe"]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7772/available+countries' --header 'Authorization: Bearer YOUR_API_KEY'
要使用此端点,您必须输入一个国家名称和一个年份(可选)。
各国假期 - 端点功能
| 对象 | 描述 |
|---|---|
country |
[必需] Indicates a country name |
year |
可选 Indicates a year |
{"country":"denmark","year":2024,"holidays":[{"date":"Jan 1 - Monday","name":"New Year's Day","type":"National Holiday","details":""},{"date":"Jan 14 - Sunday","name":"Accession of King Frederik X","type":"Observance","details":""},{"date":"Feb 11 - Sunday","name":"Carnival","type":"Observance","details":""},{"date":"Feb 14 - Wednesday","name":"Valentine's Day","type":"Observance","details":""},{"date":"Mar 20 - Wednesday","name":"March Equinox","type":"Season","details":""},{"date":"Mar 24 - Sunday","name":"Palm Sunday","type":"Observance","details":""},{"date":"Mar 28 - Thursday","name":"Maundy Thursday","type":"National Holiday","details":""},{"date":"Mar 29 - Friday","name":"Good Friday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Easter Sunday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Daylight Saving Time starts","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Apr 1 - Monday","name":"Easter Monday","type":"National Holiday","details":""},{"date":"Apr 26 - Friday","name":"Great Prayer Day","type":"Observance","details":""},{"date":"May 1 - Wednesday","name":"Labor Day / May Day","type":"Private Sector Holiday","details":""},{"date":"May 5 - Sunday","name":"Liberation Day","type":"Observance","details":""},{"date":"May 9 - Thursday","name":"Ascension Day","type":"National Holiday","details":""},{"date":"May 12 - Sunday","name":"Mother’s Day","type":"Observance","details":""},{"date":"May 19 - Sunday","name":"Whit Sunday","type":"National Holiday","details":""},{"date":"May 20 - Monday","name":"Whit Monday","type":"National Holiday","details":""},{"date":"Jun 5 - Wednesday","name":"Father’s Day","type":"Observance","details":""},{"date":"Jun 5 - Wednesday","name":"Constitution Day","type":"Private Sector Holiday","details":""},{"date":"Jun 20 - Thursday","name":"June Solstice","type":"Season","details":""},{"date":"Sep 22 - Sunday","name":"September Equinox","type":"Season","details":""},{"date":"Oct 27 - Sunday","name":"Daylight Saving Time ends","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Oct 31 - Thursday","name":"Halloween","type":"Observance","details":""},{"date":"Dec 21 - Saturday","name":"December Solstice","type":"Season","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Observance","details":""},{"date":"Dec 25 - Wednesday","name":"Christmas Day","type":"National Holiday","details":""},{"date":"Dec 26 - Thursday","name":"2nd Christmas Day","type":"National Holiday","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Observance","details":""}]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7773/holidays+by+country?country=Denmark&year=2024' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
“获取假期”端点返回指定国家和年份的假期列表,包括日期、名称、类型(公共或非公共)和星期几等详细信息。“可用国家”端点提供所有支持的国家列表。“按国家的假期”端点返回特定国家和年份的假期,详细说明日期、名称、类型和其他信息
响应数据中的关键字段包括“date”(假期日期)、“localName”(当地语言名称)、“name”(假期名称)、“type”(公共或非公共)和“countryCode”(国家的ISO代码)。这些字段有助于识别和分类每个假期
响应数据以JSON格式组织,每个假期作为数组中的一个对象呈现。每个对象包含日期、名称和类型等属性的键值对,便于程序化解析和利用
“获取假期”和“按国家获取假期”端点需要参数,例如“countryCode”(国家的ISO代码)和“year”(可选)。用户可以通过指定月份和日期来定制请求,以获取更准确的假期信息
“获取假期”接口提供指定国家和年份的假期综合列表 “可用国家”接口列出API支持的所有国家 “按国家的假期”接口提供特定国家的详细假期信息,包括节日和国定假日
用户可以利用返回的数据来计划活动、管理工作日程或制定旅行计划。例如,通过分析一年中的公共假期数量,企业可以评估潜在的运营天数并相应调整员工配置
数据来源于官方政府假期日历和信誉良好的国际数据库。这确保了API提供的假期信息的高准确性和可靠性
如果请求返回部分或空结果,用户应该验证所使用的参数,例如国家代码和年份。此外,检查API文档中的支持国家和有效日期范围可以帮助确保请求的准确性
服务级别:
100%
响应时间:
157ms
服务级别:
100%
响应时间:
1,366ms
服务级别:
100%
响应时间:
6,990ms
服务级别:
100%
响应时间:
299ms
服务级别:
100%
响应时间:
353ms
服务级别:
100%
响应时间:
270ms
服务级别:
100%
响应时间:
454ms
服务级别:
100%
响应时间:
268ms
服务级别:
100%
响应时间:
1,381ms