कोरिया सार्वजनिक अवकाश API

आधिकारिक दक्षिण कोरिया की सार्वजनिक छुट्टियां 2024-2027 जिसमें विकल्पी छुट्टियां शामिल हैं स्रोत: कोरियाई सरकार का डेटा data.go.kr के माध्यम से
इस API को अपने AI एजेंट से MCP के माध्यम से उपयोग करें
OpenClaw, Claude Code/Desktop, Cursor, Windsurf, Cline और किसी भी MCP-संगत AI क्लाइंट के साथ काम करता है।
डॉक्स और सेटअप
इस MCP को रैप करके एक स्किल बनाएं: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

कोरिया पब्लिक हॉलीडेज एपीआई 2024 से 2027 के लिए दक्षिण कोरिया के आधिकारिक सार्वजनिक छुट्टियों का डेटा प्रदान करता है, जो सीधे कोरियाई सरकार से data.go.kr (कोरिया एस्ट्रोनॉमी और स्पेस साइंस इंस्टीट्यूट) के माध्यम से लिया गया है

 

मुख्य विशेषताएँ:

  • दक्षिण कोरिया के सार्वजनिक छुट्टियों की पूर्ण सूची जिसमें विकल्पी छुट्टियाँ (대체공휴일) शामिल हैं
  • - वर्ष या विशेष महीने के अनुसार क्वेरी करें
  • - जांचें क्या कोई तिथि एक सार्वजनिक छुट्टी है
  • - अंग्रेजी छुट्टी के नामों के साथ JSON प्रारूप
  • - 2024, 2025, 2026 और 2027 को कवर करता है

एंडपॉइंट्स:

  • GET /holidays/{year} - एक वर्ष के लिए सभी छुट्टियाँ
  • - GET /holidays/{year}/{month} - एक विशेष महीने के लिए छुट्टियाँ
  • - GET /holidays/check/{date} - जांचें क्या कोई तिथि एक छुट्टी है (YYYYMMDD प्रारूप)
  • - GET /status - एपीआई स्वास्थ्य जांच

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

एंडपॉइंट्स


2024-2027 के बीच दिए गए वर्षों में दक्षिण कोरिया की सभी सार्वजनिक छुट्टियों की जानकारी लौटाएं जिसमें वैकल्पिक छुट्टियाँ शामिल हैं


                                                                            
GET https://pr137-testing.zylalabs.com/api/12464/korea+public+holidays+api/23639/get+korean+public+holidays+by+year
                                                                            
                                                                        

एंडपॉइंट टेस्ट करें

API उदाहरण प्रतिक्रिया

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"year":2026,"count":22,"holidays":[{"date":"20260101","year":2026,"month":1,"day":1,"name":"New Year's Day","name_ko":"1월1일","is_holiday":true},{"date":"20260216","year":2026,"month":2,"day":16,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260217","year":2026,"month":2,"day":17,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260218","year":2026,"month":2,"day":18,"name":"Lunar New Year's Day","name_ko":"설날","is_holiday":true},{"date":"20260301","year":2026,"month":3,"day":1,"name":"Independence Movement Day","name_ko":"삼일절","is_holiday":true},{"date":"20260302","year":2026,"month":3,"day":2,"name":"Independence Movement Day","name_ko":"대체공휴일(삼일절)","is_holiday":true},{"date":"20260501","year":2026,"month":5,"day":1,"name":"노동절","name_ko":"노동절","is_holiday":true},{"date":"20260505","year":2026,"month":5,"day":5,"name":"Children's Day","name_ko":"어린이날","is_holiday":true},{"date":"20260524","year":2026,"month":5,"day":24,"name":"Buddha's Birthday","name_ko":"부처님오신날","is_holiday":true},{"date":"20260525","year":2026,"month":5,"day":25,"name":"Buddha's Birthday","name_ko":"대체공휴일(부처님오신날)","is_holiday":true},{"date":"20260603","year":2026,"month":6,"day":3,"name":"전국동시지방선거","name_ko":"전국동시지방선거","is_holiday":true},{"date":"20260606","year":2026,"month":6,"day":6,"name":"Memorial Day","name_ko":"현충일","is_holiday":true},{"date":"20260717","year":2026,"month":7,"day":17,"name":"제헌절","name_ko":"제헌절","is_holiday":true},{"date":"20260815","year":2026,"month":8,"day":15,"name":"Liberation Day","name_ko":"광복절","is_holiday":true},{"date":"20260817","year":2026,"month":8,"day":17,"name":"Liberation Day","name_ko":"대체공휴일(광복절)","is_holiday":true},{"date":"20260924","year":2026,"month":9,"day":24,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20260925","year":2026,"month":9,"day":25,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20260926","year":2026,"month":9,"day":26,"name":"Chuseok (Korean Thanksgiving)","name_ko":"추석","is_holiday":true},{"date":"20261003","year":2026,"month":10,"day":3,"name":"National Foundation Day","name_ko":"개천절","is_holiday":true},{"date":"20261005","year":2026,"month":10,"day":5,"name":"National Foundation Day","name_ko":"대체공휴일(개천절)","is_holiday":true},{"date":"20261009","year":2026,"month":10,"day":9,"name":"Hangul Proclamation Day","name_ko":"한글날","is_holiday":true},{"date":"20261225","year":2026,"month":12,"day":25,"name":"Christmas Day","name_ko":"기독탄신일","is_holiday":true}]}
                                                                                                                                                                                                                    
                                                                                                    

वर्ष के अनुसार छुट्टियाँ प्राप्त करें - कोड स्निपेट्स


curl --location --request GET 'https://zylalabs.com/api/12464/korea+public+holidays+api/23639/get+korean+public+holidays+by+year&YEAR=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

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

साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए कोरिया सार्वजनिक अवकाश API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
हेडर्स
हेडर विवरण
Authorization [आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।

सरल पारदर्शी प्राइसिंग

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

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

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


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

ग्राहकों की पसंदीदा विशेषताएँ

  • ✔︎ केवल सफल रिक्वेस्ट के लिए भुगतान करें
  • ✔︎ फ्री 7-दिवसीय ट्रायल
  • ✔︎ मल्टी-लैंग्वेज सपोर्ट
  • ✔︎ एक API कुंजी, सभी APIs।
  • ✔︎ इंuitive डैशबोर्ड
  • ✔︎ व्यापक त्रुटि हैंडलिंग
  • ✔︎ डेवलपर-फ्रेंडली डॉक्यूमेंटेशन
  • ✔︎ पोस्टमैन इंटीग्रेशन
  • ✔︎ सुरक्षित HTTPS कनेक्शंस
  • ✔︎ विश्वसनीय अपटाइम

कोरिया सार्वजनिक अवकाश API FAQs

प्रत्येक एंडपॉइंट दक्षिण कोरिया के सार्वजनिक अवकाशों के बारे में डेटा लौटाता है जिसमें अवकाशों के नाम तारीखें और क्या वे वैकल्पिक अवकाश हैं उदाहरण के लिए एंडपॉइंट GET /holidays/{year} निर्दिष्ट वर्ष के लिए अवकाशों की पूरी सूची प्रदान करता है

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

प्रतिक्रिया के डेटा को एक JSON ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वर्ष, छुट्टियों की संख्या और छुट्टियों के ऑब्जेक्ट का एक एरे शामिल है प्रत्येक छुट्टी के ऑब्जेक्ट में विशेष विवरण शामिल हैं जैसे कि तारीख, नाम और क्या यह एक प्रतिस्थापन छुट्टी है

API सार्वजनिक छुट्टियों की जानकारी प्रदान करता है जिसमें नियमित और वैकल्पिक छुट्टियाँ शामिल हैं वर्ष 2024-2027 के लिए उपयोगकर्ता वर्ष महीने के अनुसार प्रश्न पूछ सकते हैं या विशिष्ट तिथियों की जांच कर सकते हैं

हॉलीडे के अंत बिंदुओं में "साल" (GET /holidays/{year} के लिए), "महीना" (GET /holidays/{year}/{month} के लिए), और "तारीख" (GET /holidays/check/{date} के लिए) जैसी पैरामीटर स्वीकार किए जाते हैं उपयोगकर्ता इन पैरामीटर के आधार पर अनुरोधों को अनुकूलित कर सकते हैं

इन डेटा को कोरियाई सरकार द्वारा data.go.kr के माध्यम से प्राप्त किया गया है जो यह सुनिश्चित करता है कि ये आधिकारिक और विश्वसनीय हैं यह छुट्टियों से संबंधित जानकारी की सटीकता और विश्वसनीयता को बढ़ाता है

उदाहरण के लिए उपयोग के मामले में घटनाओं की योजना बनाना कार्य का शेड्यूल बनाना और दक्षिण कोरिया में छुट्टियों के व्यावसायिक संचालन पर प्रभाव को समझना शामिल है डेवलपर्स इन डेटा को ऐप्स में एकीकृत कर सकते हैं ताकि उपयोगकर्ता छुट्टियों के बारे में जान सकें

उपयोगकर्ता JSON प्रतिक्रिया को पार्स करके लौटाए गए डेटा का उपयोग कर सकते हैं ताकि प्रासंगिक छुट्टी की जानकारी निकाली जा सके जैसे अनुप्रयोगों में आगामी छुट्टियों को प्रदर्शित करना या शेड्यूलिंग के लिए यह जांचना कि क्या विशेष तिथियाँ छुट्टियाँ हैं

GET /holidays/check/{date} एंडपॉइंट का उपयोग करें {date} को YYYYMMDD प्रारूप में इच्छित तिथि से बदलें। प्रतिक्रिया बताएगी कि तिथि एक सार्वजनिक छुट्टी है या नहीं और यदि लागू हो तो छुट्टी का नाम प्रदान करेगी

कोरिया के सार्वजनिक छुट्टियों का एपीआई 2024 से 2027 तक के सार्वजनिक छुट्टियों को कवर करता है आप उचित एंडपॉइंट का उपयोग करके इन वर्षों में से किसी भी वर्ष के लिए छुट्टियां देख सकते हैं

हाँ, आप GET /holidays/{year}/{month} एंडपॉइंट का उपयोग 2024-2027 के वर्षों के भीतर विशेष महीने के लिए छुट्टियाँ प्राप्त करने के लिए कर सकते हैं {year} और {month} को वांछित मानों के साथ बदलें

क्षेत्र "is_holiday" एक बूलियन मान है जो यह दर्शाता है कि क्या यह तिथि एक छुट्टी है यदि सत्य है तो तिथि को एक छुट्टी के रूप में पहचाना जाता है यदि असत्य है तो यह नहीं है

वैकल्पिक छुट्टियाँ छुट्टी की सूची में शामिल की गई हैं जिसमें "name" फ़ील्ड छुट्टी का नाम दिखाता है और "name_ko" फ़ील्ड कोरियाई नाम दिखाती है "is_holiday" फ़ील्ड भी इन तिथियों के लिए सच होगी

यदि एपीआई किसी विशेष महीने के लिए एक खाली सरणी लौटाता है तो इसका मतलब है कि उस महीने में कोई सार्वजनिक छुट्टियाँ नहीं हैं आप अपने ऐप में इस स्थिति को प्रबंधित कर सकते हैं और एक संदेश प्रदर्शित कर सकते हैं जिसमें कहा गया है कि कोई छुट्टियाँ उपलब्ध नहीं हैं

एपीआई प्रतिक्रिया में "नाम" फ़ील्ड के माध्यम से छुट्टी के नाम अंग्रेजी में लौटाता है सुनिश्चित करें कि आप इस फ़ील्ड को पार्स करें ताकि अपने आवेदन में छुट्टी के नाम सही तरीके से प्रदर्शित कर सकें

एपीआई डेटा को 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