कोरिया कैलेंडर API

API ID 12758

कोरियाई सार्वजनिक छुट्टियों के साथ प्रतिस्थापन-छुट्टी लॉजिक के साथ, साथ ही कोरियाई पाठ का सटीक संशोधित रोमनाइजेशन - एक तेज, शून्य-निर्भरता वाले JSON एपीआई पर वैश्विक एज के साथ किसी भी तारीख को सार्वजनिक छुट्टी है या नहीं, एक वर्ष की छुट्टियों की सूची, हंगल को रोमनाइज़ करें, या आज की कोरिया की तारीख और छुट्टी की स्थिति प्राप्त करें चंद्र-सौर रूपांतरण, 24 सौर तिथियाँ और सेक्सजेनरी चक्र v1.1 में आ रहा है

55 ms औसत रिस्पॉन्स

API डॉक्यूमेंटेशन

एंडपॉइंट्स

अनुरोध

निर्धारित वर्ष के लिए सभी दक्षिण कोरियाई सार्वजनिक छुट्टियाँ लौटाता है, जिसमें प्रतिस्थापन छुट्टियाँ भी शामिल हैं। प्रत्येक आइटम में तिथि, कोरियाई और अंग्रेजी नाम, सप्ताह का दिन और एक प्रतिस्थापन ध्वज शामिल है। वर्ष को क्वेरी पैरामीटर के रूप में पास करें, उदाहरण के लिए year=2026

Endpoint ID: 24839
GET https://docs.zylalabs.com/api/12758/korea+calendar+api/24839/list+public+holidays
इनपुट पैरामीटर्स

सार्वजनिक छुट्टियों की सूची — एंडपॉइंट फीचर्स

ऑब्जेक्ट विवरण
year आवश्यक The 4-digit year to list holidays for, for example 2026. Bundled data covers 2026-2027; production syncs any year.0

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.


इनपुट पैरामीटर्स

year
API उदाहरण प्रतिक्रिया
JSON
{
  "year": 2026,
  "count": 19,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "신정",
      "name_en": "New Year's Day",
      "substitute": false
    },
    {
      "date": "2026-02-16",
      "name": "설날 연휴",
      "name_en": "Seollal Holiday",
      "substitute": false
    },
    {
      "date": "2026-02-17",
      "name": "설날",
      "name_en": "Seollal (Lunar New Year)",
      "substitute": false
    },
    {
      "date": "2026-02-18",
      "name": "설날 연휴",
      "name_en": "Seollal Holiday",
      "substitute": false
    },
    {
      "date": "2026-03-01",
      "name": "삼일절",
      "name_en": "Independence Movement Day",
      "substitute": false
    },
    {
      "date": "2026-03-02",
      "name": "대체공휴일",
      "name_en": "Substitute Holiday",
      "substitute": true
    },
    {
      "date": "2026-05-05",
      "name": "어린이날",
      "name_en": "Children's Day",
      "substitute": false
    },
    {
      "date": "2026-05-24",
      "name": "부처님오신날",
      "name_en": "Buddha's Birthday",
      "substitute": false
    },
    {
      "date": "2026-05-25",
      "name": "대체공휴일",
      "name_en": "Substitute Holiday",
      "substitute": true
    },
    {
      "date": "2026-06-06",
      "name": "현충일",
      "name_en": "Memorial Day",
      "substitute": false
    },
    {
      "date": "2026-08-15",
      "name": "광복절",
      "name_en": "Liberation Day",
      "substitute": false
    },
    {
      "date": "2026-08-17",
      "name": "대체공휴일",
      "name_en": "Substitute Holiday",
      "substitute": true
    },
    {
      "date": "2026-09-24",
      "name": "추석 연휴",
      "name_en": "Chuseok Holiday",
      "substitute": false
    },
    {
      "date": "2026-09-25",
      "name": "추석",
      "name_en": "Chuseok (Korean Thanksgiving)",
      "substitute": false
    },
    {
      "date": "2026-09-26",
      "name": "추석 연휴",
      "name_en": "Chuseok Holiday",
      "substitute": false
    },
    {
      "date": "2026-10-03",
      "name": "개천절",
      "name_en": "National Foundation Day",
      "substitute": false
    },
    {
      "date": "2026-10-05",
      "name": "대체공휴일",
      "name_en": "Substitute Holiday",
      "substitute": true
    },
    {
      "date": "2026-10-09",
      "name": "한글날",
      "name_en": "Hangeul Day",
      "substitute": false
    },
    {
      "date": "2026-12-25",
      "name": "크리스마스",
      "name_en": "Christmas Day",
      "substitute": false
    }
  ],
  "source": "Holiday dates: statutory KR public holidays (sync KASI 특일정보, data.go.kr, KOGL Type 1)."
}
सार्वजनिक छुट्टियों की सूची — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12758/korea+calendar+api/24839/list+public+holidays?year=2026' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API एक्सेस कुंजी और प्रमाणीकरण

साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए कोरिया कैलेंडर API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।

हेडर्स
हेडर विवरण
Authorization आवश्यक होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।

कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें।

(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)

🚀 एंटरप्राइज़ प्लान

शुरू होता है
$ 10,000/वर्ष


  • कस्टम वॉल्यूम
  • कस्टम रेट लिमिट
  • विशेष ग्राहक सहायता
  • रीयल-टाइम API मॉनिटरिंग

अवलोकन

कोरिया कैलेंडर API आपको सटीक कोरियाई कैलेंडर डेटा और कोरियाई रोमनाइजेशन एक तेज, JSON, शून्य-निर्भरता API के माध्यम से प्रदान करता है जो एक वैश्विक एज पर चल रहा है

 

अब लाइव

  • सार्वजनिक छुट्टियाँ: किसी दिए गए वर्ष के लिए सभी दक्षिण कोरियाई सार्वजनिक छुट्टियों की सूची, जिसमें वैकल्पिक छुट्टियाँ शामिल हैं
  • - छुट्टी जांच: क्या एक विशेष तिथि सार्वजनिक छुट्टी है? कोरियाई और अंग्रेजी में नाम लौटाता है, सप्ताह का दिन, और एक वैकल्पिक ध्वज
  • - रोमनाइजेशन: हैंगुल को संशोधित रोमनाइजेशन में परिवर्तित करें (उदाहरण के लिए, राजधानी शहर सेओल बन जाती है, और एक सामान्य अभिवादन अन्न्योनहासेयो बन जाता है)
  • - आज: आज की कोरिया (KST) तारीख और छुट्टी की स्थिति

एंडपॉइंट्स

GET /v1/holidays?year=2026

GET /v1/holidays/is?date=2026-09-25

GET /v1/romanize?text=YOUR_TEXT

GET /v1/today

 

v1.1 में आने वाला है

चंद्र-सौर परिवर्तन, 24 सौर तत्व, और सेक्सागेनरी चक्र - डेटा जो वैश्विक छुट्टी API प्रदान नहीं करते

 

यह किसके लिए है

ऐप्स जो कोरिया, K-संस्कृति और K-पॉप उत्पादों, शेड्यूलिंग और HR उपकरणों, और कैलेंडर या ज्योतिष ऐप्स की पेशकश करते हैं जिन्हें सही कोरियाई छुट्टियों और साफ रोमनाइजेशन की आवश्यकता होती है

 

छुट्टी की दिनांकें दक्षिण कोरियाई वैधानिक छुट्टियाँ हैं (स्रोत: KASI सार्वजनिक छुट्टी डेटा डेटा.go.kr के माध्यम से)

कोरिया कैलेंडर API FAQs

प्रत्येक एंडपॉइंट कोरियाई सार्वजनिक छुट्टियों से संबंधित विशिष्ट डेटा लौटाता है हंगुल की रोमनाइज़ेशन और तारीख रूपांतरण के लिए उदाहरण के लिए छुट्टियों का एंडपॉइंट दिए गए वर्ष के लिए छुट्टियों की एक सूची प्रदान करता है जबकि रोमनाइज़ेशन एंडपॉइंट हंगुल टेक्स्ट को संशोधित रोमनाइज़ेशन में परिवर्तित करता है

मुख्य क्षेत्र में "तारीख," "नाम" (कोरियाई), "नाम_en" (अंग्रेजी), "प्रतिनिधि" (बूलियन), और चंद्र conversions के लिए "चंद्र_वर्ष," "चंद्र_महिना," और "चंद्र_दिन" शामिल हैं ये क्षेत्र छुट्टियों और तारीख परिवर्तनों के बारे में आवश्यक जानकारी प्रदान करते हैं

एंडपॉइंट "छुट्टियों" एंडपॉइंट के लिए "साल" जैसे पैरामीटर, किसी तारीख को छुट्टी है या चंद्रमा रूपांतरणों के लिए "तारीख" और रोमनाइज़ेशन के लिए "पाठ" स्वीकार करते हैं उपयोगकर्ता इन पैरामीटर्स को निर्दिष्ट करके अनुरोधों को कस्टमाइज़ कर सकते हैं

उत्तर डेटा JSON प्रारूप में संरचित है उदाहरण के लिए छुट्टियों का एंडपॉइंट एक वस्तु लौटाता है जिसमें वर्ष छुट्टियों की संख्या और छुट्टी वस्तुओं का एक सरणी होती है प्रत्येक में तिथि और दोनों भाषाओं में नाम जैसे प्रासंगिक क्षेत्र होते हैं

डेटा KASI सार्वजनिक छुट्टी डेटा से data.go.kr के जरिए लिया गया है जिससे छुट्टी की जानकारी सटीक और अपडेटेड है यह विश्वसनीय स्रोत API के डेटा की गुणवत्ता में योगदान करता है

विशिष्ट उपयोग के मामले में ऐप्स, शेड्यूलिंग टूल और एचआर सिस्टम में कोरियाई छुट्टी की जानकारी को एकीकृत करना शामिल है डेवलपर्स भाषा सीखने के ऐप्स या के-संस्कृति प्लेटफार्मों के लिए रोमनाइजेशन फीचर का उपयोग कर सकते हैं ताकि उपयोगकर्ता अनुभव को बढ़ाया जा सके

उपयोगकर्ता JSON प्रतिक्रिया को पार्स करके संबंधित जानकारी निकालने के लिए लौटाए गए डेटा का उपयोग कर सकते हैं उदाहरण के लिए वे अपनी अनुप्रयोगों में छुट्टियों के नाम और तारीखें प्रदर्शित कर सकते हैं या सांस्कृतिक या ज्योतिषीय जानकारियों के लिए चंद्रमा परिवर्तन डेटा का उपयोग कर सकते हैं

डेटा की सटीकता को विश्वसनीय स्रोतों से नियमित अपडेट और आधिकारिक अवकाश पहचान का पालन करके बनाए रखा जाता है एपीआई का डिज़ाइन यह सुनिश्चित करता है कि उपयोगकर्ताओं को कोरियाई छुट्टियों और तारीखों के बारे में सुसंगत और सटीक जानकारी प्राप्त हो।

सामान्य FAQs

Zyla API Hub APIs के लिए एक बड़ा स्टोर जैसा है, जहाँ आप हजारों APIs एक ही जगह पर पा सकते हैं। हम सभी APIs की समर्पित सपोर्ट और रीयल-टाइम मॉनिटरिंग भी प्रदान करते हैं। एक बार साइन अप करने के बाद, आप चुन सकते हैं कि कौन सी APIs उपयोग करनी हैं। बस याद रखें, प्रत्येक API को अपनी स्वयं की सब्सक्रिप्शन की आवश्यकता होती है। लेकिन यदि आप कई APIs पर सब्सक्राइब करते हैं, तो आप सभी के लिए एक ही की का उपयोग करेंगे, जिससे आपके लिए चीज़ें आसान हो जाती हैं।
कीमतें USD (अमेरिकी डॉलर), EUR (यूरो), CAD (कनाडाई डॉलर), AUD (ऑस्ट्रेलियाई डॉलर), और GBP (ब्रिटिश पाउंड) में सूचीबद्ध हैं। हम सभी प्रमुख डेबिट और क्रेडिट कार्ड स्वीकार करते हैं। हमारा पेमेंट सिस्टम नवीनतम सुरक्षा तकनीक का उपयोग करता है और Stripe द्वारा संचालित है, जो दुनिया की सबसे विश्वसनीय पेमेंट कंपनियों में से एक है। यदि आपको कार्ड से पेमेंट करने में कोई समस्या हो, तो बस हमसे संपर्क करें [email protected]

इसके अलावा, यदि आपके पास पहले से ही इनमें से किसी भी करेंसी (USD, EUR, CAD, AUD, GBP) में एक सक्रिय सब्सक्रिप्शन है, तो बाद की सब्सक्रिप्शंस के लिए वही करेंसी बनी रहेगी। जब तक आपके पास कोई सक्रिय सब्सक्रिप्शन नहीं है, आप किसी भी समय करेंसी बदल सकते हैं।
प्राइसिंग पेज पर दिखाई देने वाली स्थानीय करेंसी आपके IP पते के देश पर आधारित है और केवल संदर्भ के लिए प्रदान की गई है। वास्तविक कीमतें USD (अमेरिकी डॉलर) में हैं। जब आप भुगतान करते हैं, तो आपके कार्ड स्टेटमेंट पर चार्ज USD में दिखाई देगा, भले ही हमारी वेबसाइट पर आपको आपकी स्थानीय करेंसी में समतुल्य राशि दिखाई दे। इसका अर्थ है कि आप सीधे अपनी स्थानीय करेंसी से भुगतान नहीं कर सकते।
कभी-कभी, बैंक फ्रॉड प्रोटेक्शन सेटिंग्स के कारण चार्ज को डिक्लाइन कर सकता है। हम सुझाव देते हैं कि आप पहले अपने बैंक से संपर्क करें कि क्या वे हमारे चार्ज को ब्लॉक कर रहे हैं। साथ ही, आप बिलिंग पोर्टल तक पहुंच सकते हैं और भुगतान करने के लिए जुड़े कार्ड को बदल सकते हैं। यदि यह काम नहीं करता और आपको अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमारी टीम से संपर्क करें [email protected]
कीमतें पुनरावर्ती मासिक या वार्षिक सब्सक्रिप्शन के आधार पर निर्धारित की जाती हैं, जो चुने गए प्लान पर निर्भर करती हैं।
API कॉल्स आपके प्लान से सफल रिक्वेस्ट के आधार पर घटाई जाती हैं। प्रत्येक प्लान में प्रति माह आप जितनी कॉल कर सकते हैं उसकी एक विशेष संख्या होती है। केवल सफल कॉल्स, जो स्टेटस 200 रिस्पॉन्स से इंगित होती हैं, आपकी कुल संख्या से घटाई जाएँगी। इससे सुनिश्चित होता है कि असफल या अधूरी रिक्वेस्ट आपके मासिक कोटा को प्रभावित नहीं करतीं।
Zyla API Hub एक पुनरावर्ती मासिक सब्सक्रिप्शन सिस्टम पर काम करता है। आपका बिलिंग साइकल उस दिन से शुरू होगा जिस दिन आप किसी पेड प्लान को खरीदते हैं, और अगले महीने के उसी दिन नवीनीकृत होगा। इसलिए यदि आप भविष्य के चार्ज से बचना चाहते हैं, तो समय पर अपनी सब्सक्रिप्शन कैंसल करना सुनिश्चित करें।
अपनी मौजूदा सब्सक्रिप्शन प्लान को अपग्रेड करने के लिए, बस API के प्राइसिंग पेज पर जाएँ और वह प्लान चुनें जिस पर आप अपग्रेड करना चाहते हैं। अपग्रेड तुरंत प्रभावी होगा, जिससे आपको नए प्लान की सुविधाओं का तुरंत आनंद मिलेगा। कृपया ध्यान दें कि आपके पिछले प्लान से बची हुई कॉल्स नए प्लान में नहीं जोड़ी जाएँगी, इसलिए अपग्रेड करने से पहले इसे ध्यान में रखें। आपको नए प्लान की पूरी राशि चार्ज की जाएगी।
यह देखने के लिए कि आपके पास वर्तमान महीने के लिए कितनी API कॉल्स बची हैं, रिस्पॉन्स हेडर में "X-Zyla-API-Calls-Monthly-Remaining" फ़ील्ड देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट की अनुमति है और आपने 100 का उपयोग किया है, तो रिस्पॉन्स हेडर में यह फ़ील्ड 900 बची हुई कॉल्स दिखाएगा।
आपके प्लान में अनुमत API रिक्वेस्ट्स की अधिकतम संख्या देखने के लिए, "X-Zyla-RateLimit-Limit" रिस्पॉन्स हेडर देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट्स शामिल हैं, तो यह हेडर 1,000 दिखाएगा।
"X-Zyla-RateLimit-Reset" हेडर यह दिखाता है कि आपकी रेट लिमिट रीसेट होने में कितने सेकंड बचे हैं। यह आपको बताता है कि आपकी रिक्वेस्ट गिनती कब से फिर से शुरू होगी। उदाहरण के लिए, यदि यह 3,600 दिखाता है, तो इसका मतलब है कि लिमिट रीसेट होने में 3,600 सेकंड बचे हैं।
हाँ, आप कभी भी अपने अकाउंट में जाकर और बिलिंग पेज पर कैंसिलेशन विकल्प चुनकर अपना प्लान कैंसल कर सकते हैं। कृपया ध्यान दें कि अपग्रेड, डाउनग्रेड और कैंसिलेशन तुरंत प्रभावी होते हैं। साथ ही, कैंसल करने पर आपको सेवा तक पहुंच नहीं होगी, भले ही आपके कोटा में कॉल्स बची हों।
आपको बिना किसी प्रतिबद्धता के हमारी APIs का अनुभव करने का मौका देने के लिए, हम 7-दिवसीय फ्री ट्रायल प्रदान करते हैं, जो आपको 50 API कॉल्स तक मुफ्त में करने की अनुमति देता है। यह ट्रायल केवल एक बार उपयोग किया जा सकता है, इसलिए हम सलाह देते हैं कि आप इसे उस API पर लागू करें जिसमें आपको सबसे अधिक रुचि है। जबकि अधिकांश APIs फ्री ट्रायल प्रदान करते हैं, कुछ शायद न करें। ट्रायल 7 दिनों के बाद या 50 रिक्वेस्ट होने पर, जो भी पहले हो, समाप्त हो जाता है। यदि आप ट्रायल के दौरान 50 रिक्वेस्ट लिमिट तक पहुँच जाते हैं, तो रिक्वेस्ट जारी रखने के लिए आपको "Start Your Paid Plan" करना होगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं। यदि आप 7वें दिन से पहले अपनी सब्सक्रिप्शन कैंसल नहीं करते हैं, तो आपका फ्री ट्रायल समाप्त हो जाएगा और आपका प्लान अपने आप चार्ज हो जाएगा, जिससे आपको अपने प्लान में निर्दिष्ट सभी API कॉल्स तक पहुंच मिल जाएगी। अवांछित चार्ज से बचने के लिए कृपया इसे ध्यान में रखें।
7 दिनों के बाद, आपको उस प्लान की पूरी राशि चार्ज की जाएगी, जिस पर आप ट्रायल के दौरान सब्सक्राइब थे। इसलिए, ट्रायल अवधि समाप्त होने से पहले कैंसल करना महत्वपूर्ण है। समय पर कैंसल करना भूलने के लिए रिफंड अनुरोध स्वीकार नहीं किए जाते।
जब आप किसी API के फ्री ट्रायल पर सब्सक्राइब करते हैं, तो आप 50 API कॉल्स तक कर सकते हैं। यदि आप इस लिमिट से आगे अतिरिक्त API कॉल्स करना चाहते हैं, तो API आपको "Start Your Paid Plan" करने का संकेत देगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं।
पAYOUT ऑर्डर्स महीने की 20 तारीख से 30 तारीख के बीच प्रोसेस किए जाते हैं। यदि आप अपना अनुरोध 20 तारीख से पहले सबमिट करते हैं, तो आपका पेमेंट इस समयावधि के भीतर प्रोसेस किया जाएगा।
आप तुरंत सहायता प्राप्त करने के लिए हमारे चैट चैनल के माध्यम से हमसे संपर्क कर सकते हैं। हम हमेशा सुबह 8 बजे से शाम 5 बजे (EST) तक ऑनलाइन रहते हैं। यदि आप हमें उस समय के बाद संपर्क करते हैं, तो हम यथाशीघ्र आपसे संपर्क करेंगे। इसके अलावा, आप हमें ईमेल के माध्यम से भी संपर्क कर सकते हैं [email protected]

संबंधित APIs


आपको ये भी पसंद आ सकते हैं