![]() |
calendarific-全球節(jié)日和紀念日
專用API
【更新時間: 2024.06.11】
Calendarific 是一個對開發(fā)人員友好的全球 RESTful 應(yīng)用程序接口,可讓您訪問公共、地方和銀行節(jié)日和紀念日,覆蓋 230 多個國家、3300 多個州和 100 多種語言。
|
瀏覽次數(shù)
199
采購人數(shù)
3
試用次數(shù)
3
試用
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 定價
- 使用指南
- 常見 FAQ
- 關(guān)于我們
- 相關(guān)推薦


什么是全球節(jié)日和紀念日的calendarific?
Calendarific 是一個企業(yè)級的全球節(jié)假日和公眾假期API,它為全球超過230個國家提供詳盡的節(jié)假日數(shù)據(jù)及工作時間信息。該API旨在幫助開發(fā)者和企業(yè)無縫地將節(jié)假日信息整合到他們的應(yīng)用程序、網(wǎng)站或服務(wù)中。通過Calendarific,用戶可以獲取包括國家法定假日、地方性慶?;顒印⒆诮坦?jié)日等在內(nèi)的豐富節(jié)日數(shù)據(jù),甚至可以根據(jù)特定國家或地區(qū)進行數(shù)據(jù)定制。
什么是全球節(jié)日和紀念日的calendarific接口?
全球節(jié)日和紀念日的calendarific有哪些核心功能?
-
全球節(jié)假日數(shù)據(jù):提供超過230個國家的全面節(jié)假日信息,包括國家法定假日、地方性節(jié)日、宗教紀念日等。
-
多國語言與地區(qū)支持:支持超過100種語言和3300個地區(qū)的數(shù)據(jù),可高度定制化查詢特定區(qū)域的節(jié)日信息。
全球節(jié)日和紀念日的calendarific的核心優(yōu)勢是什么?
速度我們使用基于延遲的 DNS 路由,在 10 毫秒內(nèi)處理了 90% 以上的請求。 |
可靠性我們基于云的自動擴展服務(wù)器每天可處理超過 5 億次 API 查詢。 |
最新信息我們的數(shù)據(jù)由多個來源匯總和驗證,并定期更新。 |
在哪些場景會用到全球節(jié)日和紀念日的calendarific?
電子商務(wù)與零售行業(yè): 在線電商平臺或零售業(yè)務(wù)可以利用Calendarific API來智能調(diào)整營銷策略。例如,在特定國家的節(jié)日來臨前,電商平臺可以推送節(jié)日相關(guān)的商品促銷信息,或者調(diào)整庫存以應(yīng)對可能的銷售高峰,如圣誕節(jié)、感恩節(jié)或春節(jié)等重大節(jié)日,從而提升銷售額和用戶體驗。
|
|
人力資源管理系統(tǒng): 企業(yè)的人力資源部門可以集成Calendarific API來自動管理員工的假期安排。系統(tǒng)可以根據(jù)員工所在國家的公共假期自動調(diào)整休假安排,避免在節(jié)假日安排工作,同時幫助計算員工的帶薪假期天數(shù),確保符合當?shù)貏趧臃ㄒ?guī),提高管理效率和員工滿意度。 |
|
|


每月 | 每年 |


全球假日應(yīng)用程序接口文檔
API 基本 URL
對我們 API 的所有請求都應(yīng)發(fā)送到此端點。以下是應(yīng)用程序接口支持的端點列表
h
ttps://
calendarific.com/api/v2
應(yīng)用程序接口端點
以下是我們目前支持的 API 端點列表。請注意,對任何這些端點的請求都將計入您的 API 點擊配額。如果您使用的是免費計劃,它將計入您的配額。
/節(jié)假日 |
根據(jù)傳遞給它的參數(shù)提供假期列表。 | https://calendarific.com/api/v2/holidays |
/語言 |
該端點提供我們支持的語言列表。請注意,并非所有節(jié)假日都以所列語言指定。如果指定的語言中沒有節(jié)假日,則在大多數(shù)情況下會默認為該國的官方語言或英語。 這對于以編程方式獲取所有語言的索引和 ISO 代碼非常有用。 | https://calendarific.com/api/v2/languages |
/countries |
該端點提供了我們支持的國家和語言列表。可用于以編程方式獲取所有國家的索引和 ISO 代碼。 | https://calendarific.com/api/v2/countries |
身份驗證
向假日應(yīng)用程序接口提出的每個請求都需要一個應(yīng)用程序接口密鑰。您的 API 密鑰用于通過我們的 API 進行身份驗證,應(yīng)作為api_key
URL 參數(shù)提供。
API 密鑰可從賬戶頁面獲取。如果您不知道自己的 API 密鑰,請注冊獲取免費賬戶密鑰。
?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
api_key
應(yīng)附加到 url 請求中,如下例所示
curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
假日應(yīng)用程序接口端點參數(shù)
我們使用 URL 參數(shù)對 API 進行查詢。有兩組參數(shù),即可選參數(shù)和必選參數(shù)。對于假日 API。國家
、年份
和api_key
是所有假日 API 請求的必填參數(shù)。 不包含必填參數(shù)的請求將收到錯誤響應(yīng),無法處理。
必填 API 參數(shù)
api_key |
這是 API 的值,用于驗證對我們 API 的每個請求。 您可以在注冊并登錄賬戶后訪問該值。這是/countries 端點唯一需要的參數(shù)。 |
國家/地區(qū) |
國家參數(shù)必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國家和地區(qū)列表,請訪問我們的支持 國家 列表 。 |
年份 |
您希望返回假期的年份。我們目前支持歷史年份和未來年份,直至 2049 年。年份必須指定為數(shù)字,例如2019 |
下面是一個請求 2019 年美國所有節(jié)假日的示例。請確保將api_key
替換為賬戶頁面上的有效值。
curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'
以下是成功執(zhí)行的簡短 API 響應(yīng)
{ "meta":{ "code":200 }, "response":{ "假日":[ { "name":"假期名稱請點擊此處", "description":"假期描述請點擊此處","日期":{ "iso":"2018-12-31", "datetime":{ "year":2018, "month":12, "day":31 } }, "類型":["紀念類型在此顯示"
可選的假日 API 端點參數(shù)
我們的 API 有一系列可選參數(shù),允許用戶完善返回的結(jié)果。請注意,某些可選參數(shù)僅限付費用戶使用。以下是可選參數(shù)的完整列表
注意:可在請求中指定多個類型,以逗號分隔。
天數(shù) |
將假期數(shù)量限制在某一天。必須以日[1 ...31 ]的數(shù)值形式傳遞。 |
月 |
將節(jié)假日數(shù)量限制為某個特定月份。必須以月份[1 ..12 ] 的數(shù)值形式傳遞。 |
地點 |
我們支持所有國家的多個縣、州和地區(qū)。 通過這個可選參數(shù),您可以將節(jié)假日限制在特定的州或地區(qū)。字段值是州的iso-3166 格式 。查看支持的國家和州列表。例如,對于美國紐約州,應(yīng)為us-ny |
類型 |
我們支持多種類型的節(jié)日和紀念日。該參數(shù)允許用戶只返回特定類型的節(jié)日或活動。默認情況下,API 會返回所有節(jié)日。以下是 API 支持的節(jié)日類型列表,以及如何引用這些類型。
|
高級假日 API 端點參數(shù)
我們的 API 支持高級參數(shù),專業(yè)版及以上版本的所有用戶均可使用這些參數(shù)。如果您在沒有訂閱的情況下使用這些參數(shù),將會收到錯誤信息。
語言 |
以國家官方語言(如果有)返回假期名稱。 默認為英語。必須以2 個字母的 ISO639 語言代碼形式傳遞。例如,如果要返回所有法國法定假日的法語名稱,只需添加如下參數(shù):&language=fr |
UUID |
為響應(yīng)中返回的每個假日返回一個 UUID[true(真 )或false(假 )]。 |
HTTP 響應(yīng)代碼
每個 API 請求都會返回相應(yīng)的 HTTP 響應(yīng)代碼,下面列出了這些代碼在 API 中的含義
200 |
成功 一切順利。 |
401 |
未授權(quán) 頭信息中的 API 標記缺失或不正確。 |
422 |
無法處理的實體,意思是信息有問題,可能是 JSON 格式不正確或字段不正確。在這種情況下,響應(yīng)體包含帶有 API 錯誤代碼和信息的 JSON,其中包含出錯的詳細信息。 |
500 |
內(nèi)部服務(wù)器錯誤 這是 Calendarific 服務(wù)器在處理您的請求時出現(xiàn)的問題。在大多數(shù)情況下,信息會在處理過程中丟失,我們會收到通知,以便對問題進行調(diào)查。 |
503 |
服務(wù)不可用 在計劃的服務(wù)中斷期間,Calendarific API 服務(wù)將返回此 HTTP 響應(yīng)和相關(guān) JSON 主體。 |
429 |
請求過多。達到 API 限制。 |
API 錯誤代碼
只要 Calendarific 服務(wù)器檢測到輸入錯誤,就會返回 HTTP 422 狀態(tài)代碼以及包含錯誤詳細信息的 JSON 對象:
600 |
維護 Calendarific API 離線維護。 |
601 |
未授權(quán) 缺少或不正確的 API 令牌。 |
602 |
查詢參數(shù)無效。 |
603 |
已授權(quán) 需要訂閱級別。 |
JSON 響應(yīng)
當有人想調(diào)用我們的應(yīng)用程序接口或瀏覽我們的網(wǎng)站時,我們會嘗試自動檢測,并發(fā)回適當?shù)?JSON 響應(yīng),而不是 HTML。我們這樣做是基于已知流行編程語言、工具和框架的用戶代理。不過,在無法自動生成 JSON 響應(yīng)的情況下,我們還有其他一些方法來強制生成 JSON 響應(yīng)。一種是在 URL 中添加 /json,另一種是將接受標頭設(shè)置為 application/json:
速率限制
每天免費使用我們的 API 的次數(shù)限制為 1,000 次。如果在 24 小時內(nèi)超過 1,000 次請求,我們將返回 429 HTTP 狀態(tài)代碼。付費計劃提供月度限制和可配置的警報。
JSONP/CORS 請求
支持 JSONP 和 CORS,允許您完全在客戶端代碼中使用 Calendarific。 對于 JSONP,您只需指定回調(diào)參數(shù),例如
https://calendarific.com/?callback=callback




增強全球各行業(yè)的能力
Calendarific 的指數(shù)式增長證明了其追求卓越的堅定承諾。如今,我們?yōu)閬碜愿餍懈鳂I(yè)的 50,000 多名客戶提供服務(wù)。金融、銀行、教育、旅游、供應(yīng)鏈--不勝枚舉。人力資源專業(yè)人士、分析師和規(guī)劃師利用 API 的強大功能來應(yīng)對復(fù)雜的日程安排挑戰(zhàn),超越了其最初設(shè)想的界限。
全球努力
在一個由跨國公司和相互交織的全球經(jīng)濟所主導(dǎo)的世界里,準確的節(jié)假日數(shù)據(jù)的重要性怎么強調(diào)都不為過。Calendarific 始終站在最前沿,提供全球和地區(qū)范圍內(nèi)公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復(fù)雜的跨境業(yè)務(wù)需求。
重塑多部門戰(zhàn)略
隨著組織結(jié)構(gòu)日趨復(fù)雜,高效的多部門解決方案變得至關(guān)重要。Calendarific 應(yīng)運而生,成為解決節(jié)假日日程安排復(fù)雜問題的萬能藥。從大型企業(yè)到敏捷的初創(chuàng)公司,API 提供了一條生命線,釋放了寶貴的資源,簡化了運營。
追求卓越
我們 Calendarific 投入了巨大的精力,對 API 的準確性和效率進行了微調(diào),他們也始終樂于接受反饋意見。我們鼓勵用戶報告任何不一致或遺漏的假日信息,以便立即進行更新,這也是我們孜孜不倦追求卓越的最好證明。
在全球假日跟蹤的動態(tài)世界中,Calendarific 是無可爭議的開拓者。它對開發(fā)人員友好的方法、廣泛的覆蓋范圍以及對客戶滿意度的堅定承諾,改變了全球各行業(yè)管理節(jié)日慶?;顒拥姆绞?。隨著企業(yè)不斷駕馭復(fù)雜的現(xiàn)代環(huán)境,Calendarific 成為可靠性、效率和創(chuàng)新的燈塔--為未來的假日 API 樹立了標準。


每月 | 每年 |


全球假日應(yīng)用程序接口文檔
API 基本 URL
對我們 API 的所有請求都應(yīng)發(fā)送到此端點。以下是應(yīng)用程序接口支持的端點列表
h
ttps://
calendarific.com/api/v2
應(yīng)用程序接口端點
以下是我們目前支持的 API 端點列表。請注意,對任何這些端點的請求都將計入您的 API 點擊配額。如果您使用的是免費計劃,它將計入您的配額。
/節(jié)假日 |
根據(jù)傳遞給它的參數(shù)提供假期列表。 | https://calendarific.com/api/v2/holidays |
/語言 |
該端點提供我們支持的語言列表。請注意,并非所有節(jié)假日都以所列語言指定。如果指定的語言中沒有節(jié)假日,則在大多數(shù)情況下會默認為該國的官方語言或英語。 這對于以編程方式獲取所有語言的索引和 ISO 代碼非常有用。 | https://calendarific.com/api/v2/languages |
/countries |
該端點提供了我們支持的國家和語言列表。可用于以編程方式獲取所有國家的索引和 ISO 代碼。 | https://calendarific.com/api/v2/countries |
身份驗證
向假日應(yīng)用程序接口提出的每個請求都需要一個應(yīng)用程序接口密鑰。您的 API 密鑰用于通過我們的 API 進行身份驗證,應(yīng)作為api_key
URL 參數(shù)提供。
API 密鑰可從賬戶頁面獲取。如果您不知道自己的 API 密鑰,請注冊獲取免費賬戶密鑰。
?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
api_key
應(yīng)附加到 url 請求中,如下例所示
curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
假日應(yīng)用程序接口端點參數(shù)
我們使用 URL 參數(shù)對 API 進行查詢。有兩組參數(shù),即可選參數(shù)和必選參數(shù)。對于假日 API。國家
、年份
和api_key
是所有假日 API 請求的必填參數(shù)。 不包含必填參數(shù)的請求將收到錯誤響應(yīng),無法處理。
必填 API 參數(shù)
api_key |
這是 API 的值,用于驗證對我們 API 的每個請求。 您可以在注冊并登錄賬戶后訪問該值。這是/countries 端點唯一需要的參數(shù)。 |
國家/地區(qū) |
國家參數(shù)必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國家和地區(qū)列表,請訪問我們的支持 國家 列表 。 |
年份 |
您希望返回假期的年份。我們目前支持歷史年份和未來年份,直至 2049 年。年份必須指定為數(shù)字,例如2019 |
下面是一個請求 2019 年美國所有節(jié)假日的示例。請確保將api_key
替換為賬戶頁面上的有效值。
curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'
以下是成功執(zhí)行的簡短 API 響應(yīng)
{ "meta":{ "code":200 }, "response":{ "假日":[ { "name":"假期名稱請點擊此處", "description":"假期描述請點擊此處","日期":{ "iso":"2018-12-31", "datetime":{ "year":2018, "month":12, "day":31 } }, "類型":["紀念類型在此顯示"
可選的假日 API 端點參數(shù)
我們的 API 有一系列可選參數(shù),允許用戶完善返回的結(jié)果。請注意,某些可選參數(shù)僅限付費用戶使用。以下是可選參數(shù)的完整列表
注意:可在請求中指定多個類型,以逗號分隔。
天數(shù) |
將假期數(shù)量限制在某一天。必須以日[1 ...31 ]的數(shù)值形式傳遞。 |
月 |
將節(jié)假日數(shù)量限制為某個特定月份。必須以月份[1 ..12 ] 的數(shù)值形式傳遞。 |
地點 |
我們支持所有國家的多個縣、州和地區(qū)。 通過這個可選參數(shù),您可以將節(jié)假日限制在特定的州或地區(qū)。字段值是州的iso-3166 格式 。查看支持的國家和州列表。例如,對于美國紐約州,應(yīng)為us-ny |
類型 |
我們支持多種類型的節(jié)日和紀念日。該參數(shù)允許用戶只返回特定類型的節(jié)日或活動。默認情況下,API 會返回所有節(jié)日。以下是 API 支持的節(jié)日類型列表,以及如何引用這些類型。
|
高級假日 API 端點參數(shù)
我們的 API 支持高級參數(shù),專業(yè)版及以上版本的所有用戶均可使用這些參數(shù)。如果您在沒有訂閱的情況下使用這些參數(shù),將會收到錯誤信息。
語言 |
以國家官方語言(如果有)返回假期名稱。 默認為英語。必須以2 個字母的 ISO639 語言代碼形式傳遞。例如,如果要返回所有法國法定假日的法語名稱,只需添加如下參數(shù):&language=fr |
UUID |
為響應(yīng)中返回的每個假日返回一個 UUID[true(真 )或false(假 )]。 |
HTTP 響應(yīng)代碼
每個 API 請求都會返回相應(yīng)的 HTTP 響應(yīng)代碼,下面列出了這些代碼在 API 中的含義
200 |
成功 一切順利。 |
401 |
未授權(quán) 頭信息中的 API 標記缺失或不正確。 |
422 |
無法處理的實體,意思是信息有問題,可能是 JSON 格式不正確或字段不正確。在這種情況下,響應(yīng)體包含帶有 API 錯誤代碼和信息的 JSON,其中包含出錯的詳細信息。 |
500 |
內(nèi)部服務(wù)器錯誤 這是 Calendarific 服務(wù)器在處理您的請求時出現(xiàn)的問題。在大多數(shù)情況下,信息會在處理過程中丟失,我們會收到通知,以便對問題進行調(diào)查。 |
503 |
服務(wù)不可用 在計劃的服務(wù)中斷期間,Calendarific API 服務(wù)將返回此 HTTP 響應(yīng)和相關(guān) JSON 主體。 |
429 |
請求過多。達到 API 限制。 |
API 錯誤代碼
只要 Calendarific 服務(wù)器檢測到輸入錯誤,就會返回 HTTP 422 狀態(tài)代碼以及包含錯誤詳細信息的 JSON 對象:
600 |
維護 Calendarific API 離線維護。 |
601 |
未授權(quán) 缺少或不正確的 API 令牌。 |
602 |
查詢參數(shù)無效。 |
603 |
已授權(quán) 需要訂閱級別。 |
JSON 響應(yīng)
當有人想調(diào)用我們的應(yīng)用程序接口或瀏覽我們的網(wǎng)站時,我們會嘗試自動檢測,并發(fā)回適當?shù)?JSON 響應(yīng),而不是 HTML。我們這樣做是基于已知流行編程語言、工具和框架的用戶代理。不過,在無法自動生成 JSON 響應(yīng)的情況下,我們還有其他一些方法來強制生成 JSON 響應(yīng)。一種是在 URL 中添加 /json,另一種是將接受標頭設(shè)置為 application/json:
速率限制
每天免費使用我們的 API 的次數(shù)限制為 1,000 次。如果在 24 小時內(nèi)超過 1,000 次請求,我們將返回 429 HTTP 狀態(tài)代碼。付費計劃提供月度限制和可配置的警報。
JSONP/CORS 請求
支持 JSONP 和 CORS,允許您完全在客戶端代碼中使用 Calendarific。 對于 JSONP,您只需指定回調(diào)參數(shù),例如
https://calendarific.com/?callback=callback






增強全球各行業(yè)的能力
Calendarific 的指數(shù)式增長證明了其追求卓越的堅定承諾。如今,我們?yōu)閬碜愿餍懈鳂I(yè)的 50,000 多名客戶提供服務(wù)。金融、銀行、教育、旅游、供應(yīng)鏈--不勝枚舉。人力資源專業(yè)人士、分析師和規(guī)劃師利用 API 的強大功能來應(yīng)對復(fù)雜的日程安排挑戰(zhàn),超越了其最初設(shè)想的界限。
全球努力
在一個由跨國公司和相互交織的全球經(jīng)濟所主導(dǎo)的世界里,準確的節(jié)假日數(shù)據(jù)的重要性怎么強調(diào)都不為過。Calendarific 始終站在最前沿,提供全球和地區(qū)范圍內(nèi)公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復(fù)雜的跨境業(yè)務(wù)需求。
重塑多部門戰(zhàn)略
隨著組織結(jié)構(gòu)日趨復(fù)雜,高效的多部門解決方案變得至關(guān)重要。Calendarific 應(yīng)運而生,成為解決節(jié)假日日程安排復(fù)雜問題的萬能藥。從大型企業(yè)到敏捷的初創(chuàng)公司,API 提供了一條生命線,釋放了寶貴的資源,簡化了運營。
追求卓越
我們 Calendarific 投入了巨大的精力,對 API 的準確性和效率進行了微調(diào),他們也始終樂于接受反饋意見。我們鼓勵用戶報告任何不一致或遺漏的假日信息,以便立即進行更新,這也是我們孜孜不倦追求卓越的最好證明。
在全球假日跟蹤的動態(tài)世界中,Calendarific 是無可爭議的開拓者。它對開發(fā)人員友好的方法、廣泛的覆蓋范圍以及對客戶滿意度的堅定承諾,改變了全球各行業(yè)管理節(jié)日慶?;顒拥姆绞?。隨著企業(yè)不斷駕馭復(fù)雜的現(xiàn)代環(huán)境,Calendarific 成為可靠性、效率和創(chuàng)新的燈塔--為未來的假日 API 樹立了標準。