calendarific-全球節(jié)日和紀(jì)念日

calendarific-全球節(jié)日和紀(jì)念日

專用API
服務(wù)商 服務(wù)商: Calendarific
【更新時(shí)間: 2024.06.11】 Calendarific 是一個(gè)對(duì)開(kāi)發(fā)人員友好的全球 RESTful 應(yīng)用程序接口,可讓您訪問(wèn)公共、地方和銀行節(jié)日和紀(jì)念日,覆蓋 230 多個(gè)國(guó)家、3300 多個(gè)州和 100 多種語(yǔ)言。
免費(fèi) (支持套餐) 去服務(wù)商官網(wǎng)采購(gòu)>
瀏覽次數(shù)
227
采購(gòu)人數(shù)
3
試用次數(shù)
3
! SLA: N/A
! 響應(yīng): N/A
! 適用于個(gè)人&企業(yè)
試用
收藏
×
完成
取消
×
書簽名稱
確定
<
產(chǎn)品介紹
>

什么是全球節(jié)日和紀(jì)念日的calendarific?

Calendarific 是一個(gè)企業(yè)級(jí)的全球節(jié)假日和公眾假期API,它為全球超過(guò)230個(gè)國(guó)家提供詳盡的節(jié)假日數(shù)據(jù)及工作時(shí)間信息。該API旨在幫助開(kāi)發(fā)者和企業(yè)無(wú)縫地將節(jié)假日信息整合到他們的應(yīng)用程序、網(wǎng)站或服務(wù)中。通過(guò)Calendarific,用戶可以獲取包括國(guó)家法定假日、地方性慶祝活動(dòng)、宗教節(jié)日等在內(nèi)的豐富節(jié)日數(shù)據(jù),甚至可以根據(jù)特定國(guó)家或地區(qū)進(jìn)行數(shù)據(jù)定制。

什么是全球節(jié)日和紀(jì)念日的calendarific接口?

由服務(wù)使用方的應(yīng)用程序發(fā)起,以Restful風(fēng)格為主、通過(guò)公網(wǎng)HTTP協(xié)議調(diào)用全球節(jié)日和紀(jì)念日的calendarific ,從而實(shí)現(xiàn)程序的自動(dòng)化交互,提高服務(wù)效率。

全球節(jié)日和紀(jì)念日的calendarific有哪些核心功能?

  1. 全球節(jié)假日數(shù)據(jù):提供超過(guò)230個(gè)國(guó)家的全面節(jié)假日信息,包括國(guó)家法定假日、地方性節(jié)日、宗教紀(jì)念日等。

  2. 多國(guó)語(yǔ)言與地區(qū)支持:支持超過(guò)100種語(yǔ)言和3300個(gè)地區(qū)的數(shù)據(jù),可高度定制化查詢特定區(qū)域的節(jié)日信息。

全球節(jié)日和紀(jì)念日的calendarific的核心優(yōu)勢(shì)是什么?

速度

我們使用基于延遲的 DNS 路由,在 10 毫秒內(nèi)處理了 90% 以上的請(qǐng)求。

可靠性

我們基于云的自動(dòng)擴(kuò)展服務(wù)器每天可處理超過(guò) 5 億次 API 查詢。

最新信息

我們的數(shù)據(jù)由多個(gè)來(lái)源匯總和驗(yàn)證,并定期更新。

在哪些場(chǎng)景會(huì)用到全球節(jié)日和紀(jì)念日的calendarific?

電子商務(wù)與零售行業(yè): 在線電商平臺(tái)或零售業(yè)務(wù)可以利用Calendarific API來(lái)智能調(diào)整營(yíng)銷策略。例如,在特定國(guó)家的節(jié)日來(lái)臨前,電商平臺(tái)可以推送節(jié)日相關(guān)的商品促銷信息,或者調(diào)整庫(kù)存以應(yīng)對(duì)可能的銷售高峰,如圣誕節(jié)、感恩節(jié)或春節(jié)等重大節(jié)日,從而提升銷售額和用戶體驗(yàn)。

 

 

人力資源管理系統(tǒng): 企業(yè)的人力資源部門可以集成Calendarific API來(lái)自動(dòng)管理員工的假期安排。系統(tǒng)可以根據(jù)員工所在國(guó)家的公共假期自動(dòng)調(diào)整休假安排,避免在節(jié)假日安排工作,同時(shí)幫助計(jì)算員工的帶薪假期天數(shù),確保符合當(dāng)?shù)貏趧?dòng)法規(guī),提高管理效率和員工滿意度。

 

 

 

 

<
產(chǎn)品價(jià)格
>
每月 每年

 

<
使用指南
>

全球假日應(yīng)用程序接口文檔

API 基本 URL


對(duì)我們 API 的所有請(qǐng)求都應(yīng)發(fā)送到此端點(diǎn)。以下是應(yīng)用程序接口支持的端點(diǎn)列表

h

ttps://

calendarific.com/api/v2

應(yīng)用程序接口端點(diǎn)


以下是我們目前支持的 API 端點(diǎn)列表。請(qǐng)注意,對(duì)任何這些端點(diǎn)的請(qǐng)求都將計(jì)入您的 API 點(diǎn)擊配額。如果您使用的是免費(fèi)計(jì)劃,它將計(jì)入您的配額。

/節(jié)假日 根據(jù)傳遞給它的參數(shù)提供假期列表。 https://calendarific.com/api/v2/holidays
/語(yǔ)言 該端點(diǎn)提供我們支持的語(yǔ)言列表。請(qǐng)注意,并非所有節(jié)假日都以所列語(yǔ)言指定。如果指定的語(yǔ)言中沒(méi)有節(jié)假日,則在大多數(shù)情況下會(huì)默認(rèn)為該國(guó)的官方語(yǔ)言或英語(yǔ)。 這對(duì)于以編程方式獲取所有語(yǔ)言的索引和 ISO 代碼非常有用。 https://calendarific.com/api/v2/languages
/countries 該端點(diǎn)提供了我們支持的國(guó)家和語(yǔ)言列表。可用于以編程方式獲取所有國(guó)家的索引和 ISO 代碼。 https://calendarific.com/api/v2/countries

身份驗(yàn)證


向假日應(yīng)用程序接口提出的每個(gè)請(qǐng)求都需要一個(gè)應(yīng)用程序接口密鑰。您的 API 密鑰用于通過(guò)我們的 API 進(jìn)行身份驗(yàn)證,應(yīng)作為api_keyURL 參數(shù)提供。

 

API 密鑰可從賬戶頁(yè)面獲取。如果您不知道自己的 API 密鑰,請(qǐng)注冊(cè)獲取免費(fèi)賬戶密鑰。

?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

api_key應(yīng)附加到 url 請(qǐng)求中,如下例所示

curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

假日應(yīng)用程序接口端點(diǎn)參數(shù)


我們使用 URL 參數(shù)對(duì) API 進(jìn)行查詢。有兩組參數(shù),即可選參數(shù)和必選參數(shù)。對(duì)于假日 API。國(guó)家年份api_key是所有假日 API 請(qǐng)求的必填參數(shù)。 不包含必填參數(shù)的請(qǐng)求將收到錯(cuò)誤響應(yīng),無(wú)法處理。

必填 API 參數(shù)

api_key 這是 API 的值,用于驗(yàn)證對(duì)我們 API 的每個(gè)請(qǐng)求。 您可以在注冊(cè)并登錄賬戶后訪問(wèn)該值。這是/countries端點(diǎn)唯一需要的參數(shù)。
國(guó)家/地區(qū) 國(guó)家參數(shù)必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國(guó)家和地區(qū)列表,請(qǐng)?jiān)L問(wèn)我們的支持 國(guó)家 列表 
年份 您希望返回假期的年份。我們目前支持歷史年份和未來(lái)年份,直至 2049 年。年份必須指定為數(shù)字,例如2019

下面是一個(gè)請(qǐng)求 2019 年美國(guó)所有節(jié)假日的示例。請(qǐng)確保將api_key替換為賬戶頁(yè)面上的有效值。

curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'

以下是成功執(zhí)行的簡(jiǎn)短 API 響應(yīng)

{ "meta":{ "code":200 }, "response":{ "假日":[ { "name":"假期名稱請(qǐng)點(diǎn)擊此處", "description":"假期描述請(qǐng)點(diǎn)擊此處","日期":{ "iso":"2018-12-31", "datetime":{ "year":2018, "month":12, "day":31 } }, "類型":["紀(jì)念類型在此顯示"

可選的假日 API 端點(diǎn)參數(shù)


我們的 API 有一系列可選參數(shù),允許用戶完善返回的結(jié)果。請(qǐng)注意,某些可選參數(shù)僅限付費(fèi)用戶使用。以下是可選參數(shù)的完整列表

注意:可在請(qǐng)求中指定多個(gè)類型,以逗號(hào)分隔。

天數(shù) 將假期數(shù)量限制在某一天。必須以日[1...31]的數(shù)值形式傳遞。
將節(jié)假日數(shù)量限制為某個(gè)特定月份。必須以月份[1..12] 的數(shù)值形式傳遞。
地點(diǎn) 我們支持所有國(guó)家的多個(gè)縣、州和地區(qū)。 通過(guò)這個(gè)可選參數(shù),您可以將節(jié)假日限制在特定的州或地區(qū)。字段值是州的iso-3166 格式。查看支持的國(guó)家和州列表。例如,對(duì)于美國(guó)紐約州,應(yīng)為us-ny
類型 我們支持多種類型的節(jié)日和紀(jì)念日。該參數(shù)允許用戶只返回特定類型的節(jié)日或活動(dòng)。默認(rèn)情況下,API 會(huì)返回所有節(jié)日。以下是 API 支持的節(jié)日類型列表,以及如何引用這些類型。
  • 全國(guó)- 返回公共、聯(lián)邦和銀行假日
  • 地方- 返回地方、地區(qū)和州的節(jié)假日
  • 宗教- 返回宗教節(jié)日:佛教、基督教、印度教、伊斯蘭教等
  • observance- 節(jié)日、季節(jié)、時(shí)間

高級(jí)假日 API 端點(diǎn)參數(shù)


我們的 API 支持高級(jí)參數(shù),專業(yè)版及以上版本的所有用戶均可使用這些參數(shù)。如果您在沒(méi)有訂閱的情況下使用這些參數(shù),將會(huì)收到錯(cuò)誤信息。

語(yǔ)言 以國(guó)家官方語(yǔ)言(如果有)返回假期名稱。 默認(rèn)為英語(yǔ)。必須以2 個(gè)字母的 ISO639 語(yǔ)言代碼形式傳遞。例如,如果要返回所有法國(guó)法定假日的法語(yǔ)名稱,只需添加如下參數(shù):&language=fr
UUID 為響應(yīng)中返回的每個(gè)假日返回一個(gè) UUID[true(真)或false(假)]。

HTTP 響應(yīng)代碼


每個(gè) API 請(qǐng)求都會(huì)返回相應(yīng)的 HTTP 響應(yīng)代碼,下面列出了這些代碼在 API 中的含義

200 成功 一切順利。
401 未授權(quán) 頭信息中的 API 標(biāo)記缺失或不正確。
422 無(wú)法處理的實(shí)體,意思是信息有問(wèn)題,可能是 JSON 格式不正確或字段不正確。在這種情況下,響應(yīng)體包含帶有 API 錯(cuò)誤代碼和信息的 JSON,其中包含出錯(cuò)的詳細(xì)信息。
500 內(nèi)部服務(wù)器錯(cuò)誤 這是 Calendarific 服務(wù)器在處理您的請(qǐng)求時(shí)出現(xiàn)的問(wèn)題。在大多數(shù)情況下,信息會(huì)在處理過(guò)程中丟失,我們會(huì)收到通知,以便對(duì)問(wèn)題進(jìn)行調(diào)查。
503 服務(wù)不可用 在計(jì)劃的服務(wù)中斷期間,Calendarific API 服務(wù)將返回此 HTTP 響應(yīng)和相關(guān) JSON 主體。
429 請(qǐng)求過(guò)多。達(dá)到 API 限制。

API 錯(cuò)誤代碼


只要 Calendarific 服務(wù)器檢測(cè)到輸入錯(cuò)誤,就會(huì)返回 HTTP 422 狀態(tài)代碼以及包含錯(cuò)誤詳細(xì)信息的 JSON 對(duì)象:

600 維護(hù) Calendarific API 離線維護(hù)。
601 未授權(quán) 缺少或不正確的 API 令牌。
602 查詢參數(shù)無(wú)效。
603 已授權(quán) 需要訂閱級(jí)別。

JSON 響應(yīng)


當(dāng)有人想調(diào)用我們的應(yīng)用程序接口或?yàn)g覽我們的網(wǎng)站時(shí),我們會(huì)嘗試自動(dòng)檢測(cè),并發(fā)回適當(dāng)?shù)?JSON 響應(yīng),而不是 HTML。我們這樣做是基于已知流行編程語(yǔ)言、工具和框架的用戶代理。不過(guò),在無(wú)法自動(dòng)生成 JSON 響應(yīng)的情況下,我們還有其他一些方法來(lái)強(qiáng)制生成 JSON 響應(yīng)。一種是在 URL 中添加 /json,另一種是將接受標(biāo)頭設(shè)置為 application/json:

速率限制


每天免費(fèi)使用我們的 API 的次數(shù)限制為 1,000 次。如果在 24 小時(shí)內(nèi)超過(guò) 1,000 次請(qǐng)求,我們將返回 429 HTTP 狀態(tài)代碼。付費(fèi)計(jì)劃提供月度限制和可配置的警報(bào)。

JSONP/CORS 請(qǐng)求


支持 JSONP 和 CORS,允許您完全在客戶端代碼中使用 Calendarific。 對(duì)于 JSONP,您只需指定回調(diào)參數(shù),例如

https://calendarific.com/?callback=callback
<
產(chǎn)品問(wèn)答
>
?
Calendarific提供哪些假期數(shù)據(jù)?
Calendarific提供了大量的假日數(shù)據(jù),包括國(guó)家假日、當(dāng)?shù)丶o(jì)念活動(dòng)、宗教節(jié)日等。您可以獲取詳細(xì)信息,如假日名稱,日期,類型,甚至根據(jù)特定國(guó)家或地區(qū)自定義數(shù)據(jù)。
?
如何訪問(wèn)日歷API?
要訪問(wèn)Calendarific API,您需要在Calendarific網(wǎng)站上注冊(cè)一個(gè)API密鑰。一旦您獲得了API密鑰,就可以開(kāi)始請(qǐng)求檢索假日數(shù)據(jù)。
?
什么是日歷的假期API?
Calendarific是一個(gè)功能強(qiáng)大的API,為全球230多個(gè)國(guó)家提供全面的假期數(shù)據(jù)和營(yíng)業(yè)時(shí)間。它允許開(kāi)發(fā)人員和企業(yè)將假期信息無(wú)縫集成到他們的應(yīng)用程序,網(wǎng)站或服務(wù)中。
?
Calendarific是否適合個(gè)人和商業(yè)使用?
當(dāng)然! Calendarific旨在滿足個(gè)人,企業(yè)和開(kāi)發(fā)人員的需求。無(wú)論您是想在個(gè)人日歷中跟蹤假期,還是想將假期數(shù)據(jù)集成到商業(yè)應(yīng)用程序中,Calendarific都為所有人提供了用戶友好的解決方案。
<
關(guān)于我們
>
Calendarific
企業(yè)
Calendarific是一家提供全球假期智能平臺(tái)的公司,覆蓋超過(guò)230個(gè)國(guó)家的公共假期、地方節(jié)日和宗教節(jié)日等信息。它為開(kāi)發(fā)者和企業(yè)提供了一個(gè)簡(jiǎn)單易用、開(kāi)發(fā)者友好的API,以便將假期數(shù)據(jù)無(wú)縫集成到應(yīng)用程序、網(wǎng)站或服務(wù)中。無(wú)論是個(gè)人還是商業(yè)用途,Calendarific都能滿足不同用戶的需求。公司致力于提供卓越的服務(wù),并確保所有訂閱計(jì)劃的支付過(guò)程安全、可靠。
聯(lián)系信息
服務(wù)時(shí)間: 00:00:00至24:00:00
電話號(hào)碼: +1 774-364-2885
網(wǎng)頁(yè)在線客服: 咨詢

增強(qiáng)全球各行業(yè)的能力

Calendarific 的指數(shù)式增長(zhǎng)證明了其追求卓越的堅(jiān)定承諾。如今,我們?yōu)閬?lái)自各行各業(yè)的 50,000 多名客戶提供服務(wù)。金融、銀行、教育、旅游、供應(yīng)鏈--不勝枚舉。人力資源專業(yè)人士、分析師和規(guī)劃師利用 API 的強(qiáng)大功能來(lái)應(yīng)對(duì)復(fù)雜的日程安排挑戰(zhàn),超越了其最初設(shè)想的界限。

全球努力

在一個(gè)由跨國(guó)公司和相互交織的全球經(jīng)濟(jì)所主導(dǎo)的世界里,準(zhǔn)確的節(jié)假日數(shù)據(jù)的重要性怎么強(qiáng)調(diào)都不為過(guò)。Calendarific 始終站在最前沿,提供全球和地區(qū)范圍內(nèi)公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復(fù)雜的跨境業(yè)務(wù)需求。

重塑多部門戰(zhàn)略

隨著組織結(jié)構(gòu)日趨復(fù)雜,高效的多部門解決方案變得至關(guān)重要。Calendarific 應(yīng)運(yùn)而生,成為解決節(jié)假日日程安排復(fù)雜問(wèn)題的萬(wàn)能藥。從大型企業(yè)到敏捷的初創(chuàng)公司,API 提供了一條生命線,釋放了寶貴的資源,簡(jiǎn)化了運(yùn)營(yíng)。

追求卓越

我們 Calendarific 投入了巨大的精力,對(duì) API 的準(zhǔn)確性和效率進(jìn)行了微調(diào),他們也始終樂(lè)于接受反饋意見(jiàn)。我們鼓勵(lì)用戶報(bào)告任何不一致或遺漏的假日信息,以便立即進(jìn)行更新,這也是我們孜孜不倦追求卓越的最好證明。

在全球假日跟蹤的動(dòng)態(tài)世界中,Calendarific 是無(wú)可爭(zhēng)議的開(kāi)拓者。它對(duì)開(kāi)發(fā)人員友好的方法、廣泛的覆蓋范圍以及對(duì)客戶滿意度的堅(jiān)定承諾,改變了全球各行業(yè)管理節(jié)日慶祝活動(dòng)的方式。隨著企業(yè)不斷駕馭復(fù)雜的現(xiàn)代環(huán)境,Calendarific 成為可靠性、效率和創(chuàng)新的燈塔--為未來(lái)的假日 API 樹(shù)立了標(biāo)準(zhǔn)。

<
最可能同場(chǎng)景使用的其他API
>
API接口列表
<
產(chǎn)品價(jià)格
>
每月 每年

 

<
使用指南
>

全球假日應(yīng)用程序接口文檔

API 基本 URL


對(duì)我們 API 的所有請(qǐng)求都應(yīng)發(fā)送到此端點(diǎn)。以下是應(yīng)用程序接口支持的端點(diǎn)列表

h

ttps://

calendarific.com/api/v2

應(yīng)用程序接口端點(diǎn)


以下是我們目前支持的 API 端點(diǎn)列表。請(qǐng)注意,對(duì)任何這些端點(diǎn)的請(qǐng)求都將計(jì)入您的 API 點(diǎn)擊配額。如果您使用的是免費(fèi)計(jì)劃,它將計(jì)入您的配額。

/節(jié)假日 根據(jù)傳遞給它的參數(shù)提供假期列表。 https://calendarific.com/api/v2/holidays
/語(yǔ)言 該端點(diǎn)提供我們支持的語(yǔ)言列表。請(qǐng)注意,并非所有節(jié)假日都以所列語(yǔ)言指定。如果指定的語(yǔ)言中沒(méi)有節(jié)假日,則在大多數(shù)情況下會(huì)默認(rèn)為該國(guó)的官方語(yǔ)言或英語(yǔ)。 這對(duì)于以編程方式獲取所有語(yǔ)言的索引和 ISO 代碼非常有用。 https://calendarific.com/api/v2/languages
/countries 該端點(diǎn)提供了我們支持的國(guó)家和語(yǔ)言列表。可用于以編程方式獲取所有國(guó)家的索引和 ISO 代碼。 https://calendarific.com/api/v2/countries

身份驗(yàn)證


向假日應(yīng)用程序接口提出的每個(gè)請(qǐng)求都需要一個(gè)應(yīng)用程序接口密鑰。您的 API 密鑰用于通過(guò)我們的 API 進(jìn)行身份驗(yàn)證,應(yīng)作為api_keyURL 參數(shù)提供。

 

API 密鑰可從賬戶頁(yè)面獲取。如果您不知道自己的 API 密鑰,請(qǐng)注冊(cè)獲取免費(fèi)賬戶密鑰。

?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

api_key應(yīng)附加到 url 請(qǐng)求中,如下例所示

curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

假日應(yīng)用程序接口端點(diǎn)參數(shù)


我們使用 URL 參數(shù)對(duì) API 進(jìn)行查詢。有兩組參數(shù),即可選參數(shù)和必選參數(shù)。對(duì)于假日 API。國(guó)家年份api_key是所有假日 API 請(qǐng)求的必填參數(shù)。 不包含必填參數(shù)的請(qǐng)求將收到錯(cuò)誤響應(yīng),無(wú)法處理。

必填 API 參數(shù)

api_key 這是 API 的值,用于驗(yàn)證對(duì)我們 API 的每個(gè)請(qǐng)求。 您可以在注冊(cè)并登錄賬戶后訪問(wèn)該值。這是/countries端點(diǎn)唯一需要的參數(shù)。
國(guó)家/地區(qū) 國(guó)家參數(shù)必須采用此處文檔 中指定的 iso-3166 格式。 要查看我們支持的國(guó)家和地區(qū)列表,請(qǐng)?jiān)L問(wèn)我們的支持 國(guó)家 列表 
年份 您希望返回假期的年份。我們目前支持歷史年份和未來(lái)年份,直至 2049 年。年份必須指定為數(shù)字,例如2019

下面是一個(gè)請(qǐng)求 2019 年美國(guó)所有節(jié)假日的示例。請(qǐng)確保將api_key替換為賬戶頁(yè)面上的有效值。

curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'

以下是成功執(zhí)行的簡(jiǎn)短 API 響應(yīng)

{ "meta":{ "code":200 }, "response":{ "假日":[ { "name":"假期名稱請(qǐng)點(diǎn)擊此處", "description":"假期描述請(qǐng)點(diǎn)擊此處","日期":{ "iso":"2018-12-31", "datetime":{ "year":2018, "month":12, "day":31 } }, "類型":["紀(jì)念類型在此顯示"

可選的假日 API 端點(diǎn)參數(shù)


我們的 API 有一系列可選參數(shù),允許用戶完善返回的結(jié)果。請(qǐng)注意,某些可選參數(shù)僅限付費(fèi)用戶使用。以下是可選參數(shù)的完整列表

注意:可在請(qǐng)求中指定多個(gè)類型,以逗號(hào)分隔。

天數(shù) 將假期數(shù)量限制在某一天。必須以日[1...31]的數(shù)值形式傳遞。
將節(jié)假日數(shù)量限制為某個(gè)特定月份。必須以月份[1..12] 的數(shù)值形式傳遞。
地點(diǎn) 我們支持所有國(guó)家的多個(gè)縣、州和地區(qū)。 通過(guò)這個(gè)可選參數(shù),您可以將節(jié)假日限制在特定的州或地區(qū)。字段值是州的iso-3166 格式。查看支持的國(guó)家和州列表。例如,對(duì)于美國(guó)紐約州,應(yīng)為us-ny
類型 我們支持多種類型的節(jié)日和紀(jì)念日。該參數(shù)允許用戶只返回特定類型的節(jié)日或活動(dòng)。默認(rèn)情況下,API 會(huì)返回所有節(jié)日。以下是 API 支持的節(jié)日類型列表,以及如何引用這些類型。
  • 全國(guó)- 返回公共、聯(lián)邦和銀行假日
  • 地方- 返回地方、地區(qū)和州的節(jié)假日
  • 宗教- 返回宗教節(jié)日:佛教、基督教、印度教、伊斯蘭教等
  • observance- 節(jié)日、季節(jié)、時(shí)間

高級(jí)假日 API 端點(diǎn)參數(shù)


我們的 API 支持高級(jí)參數(shù),專業(yè)版及以上版本的所有用戶均可使用這些參數(shù)。如果您在沒(méi)有訂閱的情況下使用這些參數(shù),將會(huì)收到錯(cuò)誤信息。

語(yǔ)言 以國(guó)家官方語(yǔ)言(如果有)返回假期名稱。 默認(rèn)為英語(yǔ)。必須以2 個(gè)字母的 ISO639 語(yǔ)言代碼形式傳遞。例如,如果要返回所有法國(guó)法定假日的法語(yǔ)名稱,只需添加如下參數(shù):&language=fr
UUID 為響應(yīng)中返回的每個(gè)假日返回一個(gè) UUID[true(真)或false(假)]。

HTTP 響應(yīng)代碼


每個(gè) API 請(qǐng)求都會(huì)返回相應(yīng)的 HTTP 響應(yīng)代碼,下面列出了這些代碼在 API 中的含義

200 成功 一切順利。
401 未授權(quán) 頭信息中的 API 標(biāo)記缺失或不正確。
422 無(wú)法處理的實(shí)體,意思是信息有問(wèn)題,可能是 JSON 格式不正確或字段不正確。在這種情況下,響應(yīng)體包含帶有 API 錯(cuò)誤代碼和信息的 JSON,其中包含出錯(cuò)的詳細(xì)信息。
500 內(nèi)部服務(wù)器錯(cuò)誤 這是 Calendarific 服務(wù)器在處理您的請(qǐng)求時(shí)出現(xiàn)的問(wèn)題。在大多數(shù)情況下,信息會(huì)在處理過(guò)程中丟失,我們會(huì)收到通知,以便對(duì)問(wèn)題進(jìn)行調(diào)查。
503 服務(wù)不可用 在計(jì)劃的服務(wù)中斷期間,Calendarific API 服務(wù)將返回此 HTTP 響應(yīng)和相關(guān) JSON 主體。
429 請(qǐng)求過(guò)多。達(dá)到 API 限制。

API 錯(cuò)誤代碼


只要 Calendarific 服務(wù)器檢測(cè)到輸入錯(cuò)誤,就會(huì)返回 HTTP 422 狀態(tài)代碼以及包含錯(cuò)誤詳細(xì)信息的 JSON 對(duì)象:

600 維護(hù) Calendarific API 離線維護(hù)。
601 未授權(quán) 缺少或不正確的 API 令牌。
602 查詢參數(shù)無(wú)效。
603 已授權(quán) 需要訂閱級(jí)別。

JSON 響應(yīng)


當(dāng)有人想調(diào)用我們的應(yīng)用程序接口或?yàn)g覽我們的網(wǎng)站時(shí),我們會(huì)嘗試自動(dòng)檢測(cè),并發(fā)回適當(dāng)?shù)?JSON 響應(yīng),而不是 HTML。我們這樣做是基于已知流行編程語(yǔ)言、工具和框架的用戶代理。不過(guò),在無(wú)法自動(dòng)生成 JSON 響應(yīng)的情況下,我們還有其他一些方法來(lái)強(qiáng)制生成 JSON 響應(yīng)。一種是在 URL 中添加 /json,另一種是將接受標(biāo)頭設(shè)置為 application/json:

速率限制


每天免費(fèi)使用我們的 API 的次數(shù)限制為 1,000 次。如果在 24 小時(shí)內(nèi)超過(guò) 1,000 次請(qǐng)求,我們將返回 429 HTTP 狀態(tài)代碼。付費(fèi)計(jì)劃提供月度限制和可配置的警報(bào)。

JSONP/CORS 請(qǐng)求


支持 JSONP 和 CORS,允許您完全在客戶端代碼中使用 Calendarific。 對(duì)于 JSONP,您只需指定回調(diào)參數(shù),例如

https://calendarific.com/?callback=callback
<
依賴服務(wù)
>
<
產(chǎn)品問(wèn)答
>
?
Calendarific提供哪些假期數(shù)據(jù)?
Calendarific提供了大量的假日數(shù)據(jù),包括國(guó)家假日、當(dāng)?shù)丶o(jì)念活動(dòng)、宗教節(jié)日等。您可以獲取詳細(xì)信息,如假日名稱,日期,類型,甚至根據(jù)特定國(guó)家或地區(qū)自定義數(shù)據(jù)。
?
如何訪問(wèn)日歷API?
要訪問(wèn)Calendarific API,您需要在Calendarific網(wǎng)站上注冊(cè)一個(gè)API密鑰。一旦您獲得了API密鑰,就可以開(kāi)始請(qǐng)求檢索假日數(shù)據(jù)。
?
什么是日歷的假期API?
Calendarific是一個(gè)功能強(qiáng)大的API,為全球230多個(gè)國(guó)家提供全面的假期數(shù)據(jù)和營(yíng)業(yè)時(shí)間。它允許開(kāi)發(fā)人員和企業(yè)將假期信息無(wú)縫集成到他們的應(yīng)用程序,網(wǎng)站或服務(wù)中。
?
Calendarific是否適合個(gè)人和商業(yè)使用?
當(dāng)然! Calendarific旨在滿足個(gè)人,企業(yè)和開(kāi)發(fā)人員的需求。無(wú)論您是想在個(gè)人日歷中跟蹤假期,還是想將假期數(shù)據(jù)集成到商業(yè)應(yīng)用程序中,Calendarific都為所有人提供了用戶友好的解決方案。
<
關(guān)于我們
>
Calendarific
企業(yè)
Calendarific是一家提供全球假期智能平臺(tái)的公司,覆蓋超過(guò)230個(gè)國(guó)家的公共假期、地方節(jié)日和宗教節(jié)日等信息。它為開(kāi)發(fā)者和企業(yè)提供了一個(gè)簡(jiǎn)單易用、開(kāi)發(fā)者友好的API,以便將假期數(shù)據(jù)無(wú)縫集成到應(yīng)用程序、網(wǎng)站或服務(wù)中。無(wú)論是個(gè)人還是商業(yè)用途,Calendarific都能滿足不同用戶的需求。公司致力于提供卓越的服務(wù),并確保所有訂閱計(jì)劃的支付過(guò)程安全、可靠。
聯(lián)系信息
服務(wù)時(shí)間: 00:00:00至24:00:00
電話號(hào)碼: +1 774-364-2885
網(wǎng)頁(yè)在線客服: 咨詢

增強(qiáng)全球各行業(yè)的能力

Calendarific 的指數(shù)式增長(zhǎng)證明了其追求卓越的堅(jiān)定承諾。如今,我們?yōu)閬?lái)自各行各業(yè)的 50,000 多名客戶提供服務(wù)。金融、銀行、教育、旅游、供應(yīng)鏈--不勝枚舉。人力資源專業(yè)人士、分析師和規(guī)劃師利用 API 的強(qiáng)大功能來(lái)應(yīng)對(duì)復(fù)雜的日程安排挑戰(zhàn),超越了其最初設(shè)想的界限。

全球努力

在一個(gè)由跨國(guó)公司和相互交織的全球經(jīng)濟(jì)所主導(dǎo)的世界里,準(zhǔn)確的節(jié)假日數(shù)據(jù)的重要性怎么強(qiáng)調(diào)都不為過(guò)。Calendarific 始終站在最前沿,提供全球和地區(qū)范圍內(nèi)公共假日和銀行假日的最新信息。API 的全面覆蓋確保滿足最復(fù)雜的跨境業(yè)務(wù)需求。

重塑多部門戰(zhàn)略

隨著組織結(jié)構(gòu)日趨復(fù)雜,高效的多部門解決方案變得至關(guān)重要。Calendarific 應(yīng)運(yùn)而生,成為解決節(jié)假日日程安排復(fù)雜問(wèn)題的萬(wàn)能藥。從大型企業(yè)到敏捷的初創(chuàng)公司,API 提供了一條生命線,釋放了寶貴的資源,簡(jiǎn)化了運(yùn)營(yíng)。

追求卓越

我們 Calendarific 投入了巨大的精力,對(duì) API 的準(zhǔn)確性和效率進(jìn)行了微調(diào),他們也始終樂(lè)于接受反饋意見(jiàn)。我們鼓勵(lì)用戶報(bào)告任何不一致或遺漏的假日信息,以便立即進(jìn)行更新,這也是我們孜孜不倦追求卓越的最好證明。

在全球假日跟蹤的動(dòng)態(tài)世界中,Calendarific 是無(wú)可爭(zhēng)議的開(kāi)拓者。它對(duì)開(kāi)發(fā)人員友好的方法、廣泛的覆蓋范圍以及對(duì)客戶滿意度的堅(jiān)定承諾,改變了全球各行業(yè)管理節(jié)日慶祝活動(dòng)的方式。隨著企業(yè)不斷駕馭復(fù)雜的現(xiàn)代環(huán)境,Calendarific 成為可靠性、效率和創(chuàng)新的燈塔--為未來(lái)的假日 API 樹(shù)立了標(biāo)準(zhǔn)。

<
最可能同場(chǎng)景使用的其他API
>