कोरिया पब्लिक फेस्टिविटीज एपीआई 2024 से 2027 तक दक्षिण कोरिया के लिए आधिकारिक सार्वजनिक छुट्टियों के डेटा को प्रदान करता है, जो सीधे कोरियाई सरकार से data.go.kr (कोरिया एस्ट्रोनॉमी और स्पेस साइंस इंस्टीट्यूट) के माध्यम से प्राप्त होता है
मुख्य विशेषताएँ:
एंडपॉइंट्स:
दिए गए वर्ष (2024-2027) के लिए सभी आधिकारिक कोरियाई सार्वजनिक छुट्टियों को लौटाता है जिसमें वैकल्पिक छुट्टियाँ शामिल हैं
{"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/12504/korea+public+festivities+api/23799/get+korean+public+holidays+by+year&YEAR=Required' --header 'Authorization: Bearer YOUR_API_KEY'
किसी विशेष महीने और वर्ष के लिए सभी आधिकारिक कोरियाई सार्वजनिक छुट्टियों को प्राप्त करें। वर्ष, महीने, संख्या और छुट्टियों के ऑब्जेक्ट्स का एक एरे के साथ JSON ऑब्जेक्ट लौटाता है। प्रत्येक छुट्टी में दिनांक (YYYYMMDD प्रारूप), व्यक्तिगत वर्ष/महीना/दिन फ़ील्ड, अंग्रेजी नाम, कोरियाई नाम (name_ko), और is_holiday फ़्लैग शामिल है। मासिक कैलेंडर अनुप्रयोगों, पेरोल सिस्टम और एचआर प्लेटफार्मों के लिए उपयोगी। डेटा का स्रोत data.go.kr है। समर्थित वर्ष: 2024-2027
{"year":2026,"month":1,"count":1,"holidays":[{"date":"20260101","year":2026,"month":1,"day":1,"name":"New Year's Day","name_ko":"1월1일","is_holiday":true}]}
curl --location --request GET 'https://zylalabs.com/api/12504/korea+public+festivities+api/23800/get+korean+holidays+by+month&YEAR=Required&/=Required&MONTH=Required' --header 'Authorization: Bearer YOUR_API_KEY'
जल्दी से जाँच करें कि क्या एक विशिष्ट तिथि एक कोरियाई सार्वजनिक छुट्टी है। YYYY-MM-DD प्रारूप में तिथि पास करें। यह एक JSON वस्तु लौटाता है जो दर्शाता है कि क्या तिथि छुट्टी है, साथ ही जब लागू हो तो छुट्टी का नाम (अंग्रेजी और कोरियाई) भी। व्यवसायिक तार्किकता, कार्यक्रम बनाना, अवकाश/PTO गणनाओं, और किसी भी आवेदन के लिए उपयोगी जो यह जानना चाहता है कि क्या दिया गया दिन दक्षिण कोरिया में कामकाजी दिन है। डेटा data.go.kr से प्राप्त किया गया है। समर्थित तिथि सीमा: 2024-01-01 से 2027-12-31 है।
{"date":"20260101","is_holiday":true,"name":"New Year's Day"}
curl --location --request GET 'https://zylalabs.com/api/12504/korea+public+festivities+api/23801/check+if+date+is+korean+holiday&DATE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक अंतिम बिंदु दक्षिण कोरिया के सार्वजनिक अवकाश डेटा को लौटाता है जिसमें अवकाश के नाम, तिथियाँ और क्या वे प्रतिस्थापन अवकाश हैं शामिल हैं उदाहरण के लिए GET /holidays/{year} अंतिम बिंदु निर्दिष्ट वर्ष के लिए अवकाशों की पूरी सूची प्रदान करता है
प्रतिक्रिया में मुख्य फ़ील्ड "तारीख" (YYYYMMDD प्रारूप), "वर्ष," "महीना," "दिन," "नाम" (अंग्रेजी), "नाम_को" (कोरियाई), और "है_छुट्टी" (बूलियन यह संकेत करता है कि यह छुट्टी है) शामिल हैं
प्रतिक्रिया डेटा को एक JSON ऑब्जेक्ट के रूप में संरचित किया गया है जिसमें वर्ष, छुट्टियों की संख्या और छुट्टियों की ऑब्जेक्ट्स की एक सूची शामिल है प्रत्येक छुट्टी ऑब्जेक्ट में विशेष विवरण होते हैं जैसे तिथि, नाम और क्या यह एक विकल्प छुट्टी है
एपीआई 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" क्षेत्र भी इन तारीखों के लिए सत्य होगा
यदि एपीआई किसी विशेष महीने के लिए एक खाली सरणी लौटाता है, इसका मतलब है कि उस महीने में कोई सार्वजनिक छुट्टियाँ नहीं हैं। आप अपने एप्लिकेशन में इस स्थिति को संभाल सकते हैं, एक संदेश दिखाकर जो बताता है कि कोई छुट्टियाँ उपलब्ध नहीं हैं
API "name" क्षेत्र के माध्यम से प्रतिक्रिया में अवकाश के नाम अंग्रेजी में लौटाता है सुनिश्चित करें कि आप इस क्षेत्र को पार्स करें ताकि अपने अनुप्रयोग में अवकाश के नाम सही ढंग से प्रदर्शित हो सकें
API डेटा को JSON प्रारूप में लौटाता है प्रत्येक प्रतिक्रिया में "वर्ष," "गिनती," और छुट्टी की वस्तुओं के एक ऐरे जैसे फ़ील्ड के साथ एक संरचित ऑब्जेक्ट शामिल होता है जिससे इसे पार्स करना और अनुप्रयोगों में उपयोग करना आसान हो जाता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
338ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,470ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
419ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,127ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,016ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,236ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
827ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
151ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,346ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
458ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
889ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
20ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
391ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
342ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
614ms
सर्विस लेवल:
99%
रिस्पॉन्स टाइम:
23ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,073ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,636ms
सर्विस लेवल:
99%
रिस्पॉन्स टाइम:
16ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
17ms