 |
calendarific-全球節日和紀念日
專用API
【更新時間: 2024.06.11】
Calendarific 是一個對開發人員友好的全球 RESTful 應用程序接口，可讓您訪問公共、地方和銀行節日和紀念日，覆蓋 230 多個國家、3300 多個州和 100 多種語言。
|
瀏覽次數
193
采購人數
3
試用次數
3
SLA: N/A
響應: N/A
適用于個人&企業
試用
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 定價
- 使用指南
- 常見 FAQ
- 關于我們
- 相關推薦
什么是全球節日和紀念日的calendarific?
Calendarific 是一個企業級的全球節假日和公眾假期API，它為全球超過230個國家提供詳盡的節假日數據及工作時間信息。該API旨在幫助開發者和企業無縫地將節假日信息整合到他們的應用程序、網站或服務中。通過Calendarific，用戶可以獲取包括國家法定假日、地方性慶祝活動、宗教節日等在內的豐富節日數據，甚至可以根據特定國家或地區進行數據定制。
什么是全球節日和紀念日的calendarific接口？
全球節日和紀念日的calendarific有哪些核心功能？
-
全球節假日數據：提供超過230個國家的全面節假日信息，包括國家法定假日、地方性節日、宗教紀念日等。
-
多國語言與地區支持：支持超過100種語言和3300個地區的數據，可高度定制化查詢特定區域的節日信息。
全球節日和紀念日的calendarific的核心優勢是什么？
 |
 |
 |
速度我們使用基于延遲的 DNS 路由，在 10 毫秒內處理了 90% 以上的請求。 |
可靠性我們基于云的自動擴展服務器每天可處理超過 5 億次 API 查詢。 |
最新信息我們的數據由多個來源匯總和驗證，并定期更新。 |
在哪些場景會用到全球節日和紀念日的calendarific？
|
電子商務與零售行業: 在線電商平臺或零售業務可以利用Calendarific API來智能調整營銷策略。例如，在特定國家的節日來臨前，電商平臺可以推送節日相關的商品促銷信息，或者調整庫存以應對可能的銷售高峰，如圣誕節、感恩節或春節等重大節日，從而提升銷售額和用戶體驗。
|
|
| 人力資源管理系統: 企業的人力資源部門可以集成Calendarific API來自動管理員工的假期安排。系統可以根據員工所在國家的公共假期自動調整休假安排，避免在節假日安排工作，同時幫助計算員工的帶薪假期天數，確保符合當地勞動法規，提高管理效率和員工滿意度。 |
|
|
|
| 每月 | 每年 |
全球假日應用程序接口文檔
API 基本 URL
對我們 API 的所有請求都應發送到此端點。以下是應用程序接口支持的端點列表
h
ttps://
calendarific.com/api/v2
應用程序接口端點
以下是我們目前支持的 API 端點列表。請注意，對任何這些端點的請求都將計入您的 API 點擊配額。如果您使用的是免費計劃，它將計入您的配額。
/節假日 |
根據傳遞給它的參數提供假期列表。 | https://calendarific.com/api/v2/holidays |
/語言 |
該端點提供我們支持的語言列表。請注意，并非所有節假日都以所列語言指定。如果指定的語言中沒有節假日，則在大多數情況下會默認為該國的官方語言或英語。 這對于以編程方式獲取所有語言的索引和 ISO 代碼非常有用。 | https://calendarific.com/api/v2/languages |
/countries |
該端點提供了我們支持的國家和語言列表。可用于以編程方式獲取所有國家的索引和 ISO 代碼。 | https://calendarific.com/api/v2/countries |
身份驗證
向假日應用程序接口提出的每個請求都需要一個應用程序接口密鑰。您的 API 密鑰用于通過我們的 API 進行身份驗證，應作為api_keyURL 參數提供。
API 密鑰可從賬戶頁面獲取。如果您不知道自己的 API 密鑰，請注冊獲取免費賬戶密鑰。
?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
api_key應附加到 url 請求中，如下例所示
curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
假日應用程序接口端點參數
我們使用 URL 參數對 API 進行查詢。有兩組參數，即可選參數和必選參數。對于假日 API。國家、年份和api_key是所有假日 API 請求的必填參數。 不包含必填參數的請求將收到錯誤響應，無法處理。
必填 API 參數
api_key |
這是 API 的值，用于驗證對我們 API 的每個請求。 您可以在注冊并登錄賬戶后訪問該值。這是/countries端點唯一需要的參數。 |
國家/地區 |
國家參數必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國家和地區列表，請訪問我們的支持 國家 列表 。 |
年份 |
您希望返回假期的年份。我們目前支持歷史年份和未來年份，直至 2049 年。年份必須指定為數字，例如2019 |
下面是一個請求 2019 年美國所有節假日的示例。請確保將api_key替換為賬戶頁面上的有效值。
curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'
以下是成功執行的簡短 API 響應
{ "meta"：{ "code"：200 }, "response"：{ "假日"：[ { "name"："假期名稱請點擊此處", "description"："假期描述請點擊此處"，"日期"：{ "iso"："2018-12-31", "datetime"：{ "year"：2018, "month"：12, "day"：31 } }, "類型"：["紀念類型在此顯示"
可選的假日 API 端點參數
我們的 API 有一系列可選參數，允許用戶完善返回的結果。請注意，某些可選參數僅限付費用戶使用。以下是可選參數的完整列表
注意：可在請求中指定多個類型，以逗號分隔。
天數 |
將假期數量限制在某一天。必須以日[1...31]的數值形式傳遞。 |
月 |
將節假日數量限制為某個特定月份。必須以月份[1..12] 的數值形式傳遞。 |
地點 |
我們支持所有國家的多個縣、州和地區。 通過這個可選參數，您可以將節假日限制在特定的州或地區。字段值是州的iso-3166 格式。查看支持的國家和州列表。例如，對于美國紐約州，應為us-ny |
類型 |
我們支持多種類型的節日和紀念日。該參數允許用戶只返回特定類型的節日或活動。默認情況下，API 會返回所有節日。以下是 API 支持的節日類型列表，以及如何引用這些類型。
|
高級假日 API 端點參數
我們的 API 支持高級參數，專業版及以上版本的所有用戶均可使用這些參數。如果您在沒有訂閱的情況下使用這些參數，將會收到錯誤信息。
語言 |
以國家官方語言（如果有）返回假期名稱。 默認為英語。必須以2 個字母的 ISO639 語言代碼形式傳遞。例如，如果要返回所有法國法定假日的法語名稱，只需添加如下參數：&language=fr |
UUID |
為響應中返回的每個假日返回一個 UUID[true（真）或false（假）]。 |
HTTP 響應代碼
每個 API 請求都會返回相應的 HTTP 響應代碼，下面列出了這些代碼在 API 中的含義
200 |
成功 一切順利。 |
401 |
未授權 頭信息中的 API 標記缺失或不正確。 |
422 |
無法處理的實體，意思是信息有問題，可能是 JSON 格式不正確或字段不正確。在這種情況下，響應體包含帶有 API 錯誤代碼和信息的 JSON，其中包含出錯的詳細信息。 |
500 |
內部服務器錯誤 這是 Calendarific 服務器在處理您的請求時出現的問題。在大多數情況下，信息會在處理過程中丟失，我們會收到通知，以便對問題進行調查。 |
503 |
服務不可用 在計劃的服務中斷期間，Calendarific API 服務將返回此 HTTP 響應和相關 JSON 主體。 |
429 |
請求過多。達到 API 限制。 |
API 錯誤代碼
只要 Calendarific 服務器檢測到輸入錯誤，就會返回 HTTP 422 狀態代碼以及包含錯誤詳細信息的 JSON 對象：
600 |
維護 Calendarific API 離線維護。 |
601 |
未授權 缺少或不正確的 API 令牌。 |
602 |
查詢參數無效。 |
603 |
已授權 需要訂閱級別。 |
JSON 響應
當有人想調用我們的應用程序接口或瀏覽我們的網站時，我們會嘗試自動檢測，并發回適當的 JSON 響應，而不是 HTML。我們這樣做是基于已知流行編程語言、工具和框架的用戶代理。不過，在無法自動生成 JSON 響應的情況下，我們還有其他一些方法來強制生成 JSON 響應。一種是在 URL 中添加 /json，另一種是將接受標頭設置為 application/json：
速率限制
每天免費使用我們的 API 的次數限制為 1,000 次。如果在 24 小時內超過 1,000 次請求，我們將返回 429 HTTP 狀態代碼。付費計劃提供月度限制和可配置的警報。
JSONP/CORS 請求
支持 JSONP 和 CORS，允許您完全在客戶端代碼中使用 Calendarific。 對于 JSONP，您只需指定回調參數，例如
https://calendarific.com/?callback=callback
增強全球各行業的能力
Calendarific 的指數式增長證明了其追求卓越的堅定承諾。如今，我們為來自各行各業的 50,000 多名客戶提供服務。金融、銀行、教育、旅游、供應鏈--不勝枚舉。人力資源專業人士、分析師和規劃師利用 API 的強大功能來應對復雜的日程安排挑戰，超越了其最初設想的界限。
全球努力
在一個由跨國公司和相互交織的全球經濟所主導的世界里，準確的節假日數據的重要性怎么強調都不為過。Calendarific 始終站在最前沿，提供全球和地區范圍內公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復雜的跨境業務需求。
重塑多部門戰略
隨著組織結構日趨復雜，高效的多部門解決方案變得至關重要。Calendarific 應運而生，成為解決節假日日程安排復雜問題的萬能藥。從大型企業到敏捷的初創公司，API 提供了一條生命線，釋放了寶貴的資源，簡化了運營。
追求卓越
我們 Calendarific 投入了巨大的精力，對 API 的準確性和效率進行了微調，他們也始終樂于接受反饋意見。我們鼓勵用戶報告任何不一致或遺漏的假日信息，以便立即進行更新，這也是我們孜孜不倦追求卓越的最好證明。
在全球假日跟蹤的動態世界中，Calendarific 是無可爭議的開拓者。它對開發人員友好的方法、廣泛的覆蓋范圍以及對客戶滿意度的堅定承諾，改變了全球各行業管理節日慶祝活動的方式。隨著企業不斷駕馭復雜的現代環境，Calendarific 成為可靠性、效率和創新的燈塔--為未來的假日 API 樹立了標準。
| 每月 | 每年 |
全球假日應用程序接口文檔
API 基本 URL
對我們 API 的所有請求都應發送到此端點。以下是應用程序接口支持的端點列表
h
ttps://
calendarific.com/api/v2
應用程序接口端點
以下是我們目前支持的 API 端點列表。請注意，對任何這些端點的請求都將計入您的 API 點擊配額。如果您使用的是免費計劃，它將計入您的配額。
/節假日 |
根據傳遞給它的參數提供假期列表。 | https://calendarific.com/api/v2/holidays |
/語言 |
該端點提供我們支持的語言列表。請注意，并非所有節假日都以所列語言指定。如果指定的語言中沒有節假日，則在大多數情況下會默認為該國的官方語言或英語。 這對于以編程方式獲取所有語言的索引和 ISO 代碼非常有用。 | https://calendarific.com/api/v2/languages |
/countries |
該端點提供了我們支持的國家和語言列表。可用于以編程方式獲取所有國家的索引和 ISO 代碼。 | https://calendarific.com/api/v2/countries |
身份驗證
向假日應用程序接口提出的每個請求都需要一個應用程序接口密鑰。您的 API 密鑰用于通過我們的 API 進行身份驗證，應作為api_keyURL 參數提供。
API 密鑰可從賬戶頁面獲取。如果您不知道自己的 API 密鑰，請注冊獲取免費賬戶密鑰。
?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
api_key應附加到 url 請求中，如下例所示
curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs
假日應用程序接口端點參數
我們使用 URL 參數對 API 進行查詢。有兩組參數，即可選參數和必選參數。對于假日 API。國家、年份和api_key是所有假日 API 請求的必填參數。 不包含必填參數的請求將收到錯誤響應，無法處理。
必填 API 參數
api_key |
這是 API 的值，用于驗證對我們 API 的每個請求。 您可以在注冊并登錄賬戶后訪問該值。這是/countries端點唯一需要的參數。 |
國家/地區 |
國家參數必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國家和地區列表，請訪問我們的支持 國家 列表 。 |
年份 |
您希望返回假期的年份。我們目前支持歷史年份和未來年份，直至 2049 年。年份必須指定為數字，例如2019 |
下面是一個請求 2019 年美國所有節假日的示例。請確保將api_key替換為賬戶頁面上的有效值。
curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'
以下是成功執行的簡短 API 響應
{ "meta"：{ "code"：200 }, "response"：{ "假日"：[ { "name"："假期名稱請點擊此處", "description"："假期描述請點擊此處"，"日期"：{ "iso"："2018-12-31", "datetime"：{ "year"：2018, "month"：12, "day"：31 } }, "類型"：["紀念類型在此顯示"
可選的假日 API 端點參數
我們的 API 有一系列可選參數，允許用戶完善返回的結果。請注意，某些可選參數僅限付費用戶使用。以下是可選參數的完整列表
注意：可在請求中指定多個類型，以逗號分隔。
天數 |
將假期數量限制在某一天。必須以日[1...31]的數值形式傳遞。 |
月 |
將節假日數量限制為某個特定月份。必須以月份[1..12] 的數值形式傳遞。 |
地點 |
我們支持所有國家的多個縣、州和地區。 通過這個可選參數，您可以將節假日限制在特定的州或地區。字段值是州的iso-3166 格式。查看支持的國家和州列表。例如，對于美國紐約州，應為us-ny |
類型 |
我們支持多種類型的節日和紀念日。該參數允許用戶只返回特定類型的節日或活動。默認情況下，API 會返回所有節日。以下是 API 支持的節日類型列表，以及如何引用這些類型。
|
高級假日 API 端點參數
我們的 API 支持高級參數，專業版及以上版本的所有用戶均可使用這些參數。如果您在沒有訂閱的情況下使用這些參數，將會收到錯誤信息。
語言 |
以國家官方語言（如果有）返回假期名稱。 默認為英語。必須以2 個字母的 ISO639 語言代碼形式傳遞。例如，如果要返回所有法國法定假日的法語名稱，只需添加如下參數：&language=fr |
UUID |
為響應中返回的每個假日返回一個 UUID[true（真）或false（假）]。 |
HTTP 響應代碼
每個 API 請求都會返回相應的 HTTP 響應代碼，下面列出了這些代碼在 API 中的含義
200 |
成功 一切順利。 |
401 |
未授權 頭信息中的 API 標記缺失或不正確。 |
422 |
無法處理的實體，意思是信息有問題，可能是 JSON 格式不正確或字段不正確。在這種情況下，響應體包含帶有 API 錯誤代碼和信息的 JSON，其中包含出錯的詳細信息。 |
500 |
內部服務器錯誤 這是 Calendarific 服務器在處理您的請求時出現的問題。在大多數情況下，信息會在處理過程中丟失，我們會收到通知，以便對問題進行調查。 |
503 |
服務不可用 在計劃的服務中斷期間，Calendarific API 服務將返回此 HTTP 響應和相關 JSON 主體。 |
429 |
請求過多。達到 API 限制。 |
API 錯誤代碼
只要 Calendarific 服務器檢測到輸入錯誤，就會返回 HTTP 422 狀態代碼以及包含錯誤詳細信息的 JSON 對象：
600 |
維護 Calendarific API 離線維護。 |
601 |
未授權 缺少或不正確的 API 令牌。 |
602 |
查詢參數無效。 |
603 |
已授權 需要訂閱級別。 |
JSON 響應
當有人想調用我們的應用程序接口或瀏覽我們的網站時，我們會嘗試自動檢測，并發回適當的 JSON 響應，而不是 HTML。我們這樣做是基于已知流行編程語言、工具和框架的用戶代理。不過，在無法自動生成 JSON 響應的情況下，我們還有其他一些方法來強制生成 JSON 響應。一種是在 URL 中添加 /json，另一種是將接受標頭設置為 application/json：
速率限制
每天免費使用我們的 API 的次數限制為 1,000 次。如果在 24 小時內超過 1,000 次請求，我們將返回 429 HTTP 狀態代碼。付費計劃提供月度限制和可配置的警報。
JSONP/CORS 請求
支持 JSONP 和 CORS，允許您完全在客戶端代碼中使用 Calendarific。 對于 JSONP，您只需指定回調參數，例如
https://calendarific.com/?callback=callback
增強全球各行業的能力
Calendarific 的指數式增長證明了其追求卓越的堅定承諾。如今，我們為來自各行各業的 50,000 多名客戶提供服務。金融、銀行、教育、旅游、供應鏈--不勝枚舉。人力資源專業人士、分析師和規劃師利用 API 的強大功能來應對復雜的日程安排挑戰，超越了其最初設想的界限。
全球努力
在一個由跨國公司和相互交織的全球經濟所主導的世界里，準確的節假日數據的重要性怎么強調都不為過。Calendarific 始終站在最前沿，提供全球和地區范圍內公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復雜的跨境業務需求。
重塑多部門戰略
隨著組織結構日趨復雜，高效的多部門解決方案變得至關重要。Calendarific 應運而生，成為解決節假日日程安排復雜問題的萬能藥。從大型企業到敏捷的初創公司，API 提供了一條生命線，釋放了寶貴的資源，簡化了運營。
追求卓越
我們 Calendarific 投入了巨大的精力，對 API 的準確性和效率進行了微調，他們也始終樂于接受反饋意見。我們鼓勵用戶報告任何不一致或遺漏的假日信息，以便立即進行更新，這也是我們孜孜不倦追求卓越的最好證明。
在全球假日跟蹤的動態世界中，Calendarific 是無可爭議的開拓者。它對開發人員友好的方法、廣泛的覆蓋范圍以及對客戶滿意度的堅定承諾，改變了全球各行業管理節日慶祝活動的方式。隨著企業不斷駕馭復雜的現代環境，Calendarific 成為可靠性、效率和創新的燈塔--為未來的假日 API 樹立了標準。
