कोरिया पब्लिक हॉलीडेज एपीआई 2024 से 2027 के लिए दक्षिण कोरिया के आधिकारिक सार्वजनिक छुट्टियों का डेटा प्रदान करता है, जो सीधे कोरियाई सरकार से data.go.kr (कोरिया एस्ट्रोनॉमी और स्पेस साइंस इंस्टीट्यूट) के माध्यम से लिया गया है
मुख्य विशेषताएँ:
एंडपॉइंट्स:
{"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'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक एंडपॉइंट दक्षिण कोरिया के सार्वजनिक अवकाशों के बारे में डेटा लौटाता है जिसमें अवकाशों के नाम तारीखें और क्या वे वैकल्पिक अवकाश हैं उदाहरण के लिए एंडपॉइंट 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 प्रारूप में लौटाता है प्रत्येक प्रतिक्रिया में "वर्ष" "गिनती" जैसे फ़ील्ड और छुट्टियों की वस्तुओं के एक सरणी के साथ एक संरचित ऑब्जेक्ट शामिल होता है जो विश्लेषण और अनुप्रयोगों में उपयोग को आसान बनाता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,127ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,470ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,256ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,429ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
280ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,896ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,056ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
800ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,303ms