{"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/12474/hr+payroll+korea+public+holidays+api/23691/get+korean+public+holidays+by+year&YEAR=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"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/12474/hr+payroll+korea+public+holidays+api/23692/get+korean+holidays+by+month&YEAR=Required&/=Required&MONTH=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"date":"20260101","is_holiday":true,"name":"New Year's Day"}
curl --location --request GET 'https://zylalabs.com/api/12474/hr+payroll+korea+public+holidays+api/23693/check+if+date+is+korean+holiday&DATE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए एचआर तनख्वाह कोरिया सार्वजनिक छुट्टियां API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
कोरिया के मानव संसाधन के सार्वजनिक छुट्टियों के API 2024 से 2027 तक दक्षिण कोरिया के लिए सार्वजनिक छुट्टियों के आधिकारिक डेटा प्रदान करता है जिसे सीधे कोरियाई सरकार से data.go.kr (कोरिया का खगोल विज्ञान और अंतरिक्ष विज्ञान संस्थान) के माध्यम से प्राप्त किया गया है
मुख्य विशेषताएँ:
एक्सेस बिंदु:
प्रत्येक एन्डपॉइंट दक्षिण कोरिया के सार्वजनिक छुट्टियों के डेटा को लौटाता है जिसमें छुट्टियों के नाम तारीखें और क्या वे वैकल्पिक छुट्टियाँ हैं शामिल हैं उदाहरण के लिए GET /holidays/{year} एन्डपॉइंट निर्दिष्ट वर्ष के लिए छुट्टियों की पूरी सूची प्रदान करता है
प्रतिक्रिया में प्रमुख क्षेत्र शामिल हैं "तारीख" (फॉर्मेट AAAAMMDD), "वर्ष," "माह," "दिन," "नाम" (अंग्रेजी), "नाम_को" (कोरियाई) और "es_feriado" (बूलियन जो दर्शाता है कि यह एक छुट्टी है)
यह प्रतिक्रिया डेटा एक JSON ऑब्जेक्ट के रूप में संरचित है जिसमें वर्ष, छुट्टियों की संख्या और छुट्टियों के ऑब्जेक्ट्स का एक ऐरे शामिल है प्रत्येक छुट्टी ऑब्जेक्ट में विशेष विवरण शामिल हैं जैसे तिथि, नाम और क्या यह एक विकल्प छुट्टी है
एपीआई 2024-2027 के वर्षों के लिए सार्वजनिक छुट्टियों की जानकारी प्रदान करता है जिसमें नियमित और वैकल्पिक छुट्टियां शामिल हैं उपयोगकर्ता वर्ष महीने के अनुसार प्रश्न पूछ सकते हैं या विशिष्ट तारीखें देख सकते हैं
अंतिम बिंदु "वर्ष" (GET /holidays/{year} के लिए) "महीना" (GET /holidays/{year}/{month} के लिए) और "तारीख" (GET /holidays/check/{date} के लिए) जैसे पैरामीटर्स स्वीकार करते हैं उपयोगकर्ता इन पैरामीटर्स के आधार पर अनुरोधों को वैयक्तिकृत कर सकते हैं
यह डेटा कोरियाई सरकार से data.go.kr के माध्यम से प्राप्त किया गया है जिससे यह आधिकारिक और विश्वसनीय है यह छुट्टी की जानकारी की सटीकता और विश्वसनीयता को बढ़ाता है
सामान्य उपयोग के मामले में ईवेंट की योजना बनाना कार्य की कार्यक्रमबद्धता और दक्षिण कोरिया में छुट्टियों के प्रभाव को व्यावसायिक संचालन में समझना शामिल है डेवलपर्स इन डेटा को छुट्टियों के बारे में उपयोगकर्ताओं की जागरूकता के लिए एप्लिकेशन में एकीकृत कर सकते हैं
उपयोगकर्ता प्रत्यावर्तित डेटा का उपयोग JSON प्रतिक्रिया को पार्स करके संबंधित छुट्टी की जानकारी निकालने के लिए कर सकते हैं जैसे कि अनुप्रयोगों में आगामी छुट्टियों को दिखाना या तय करने के उद्देश्यों के लिए यह जांचना कि क्या विशिष्ट तिथियाँ छुट्टियाँ हैं
GET /holidays/check/{date} एंडपॉइंट का उपयोग करें {date} को वांछित तिथि के साथ AAAAMMDD प्रारूप में बदलते हुए उत्तर में यह सूचित किया जाएगा कि क्या यह तिथि एक त्योहार का दिन है और यदि आवश्यक हो तो त्योहार का नाम प्रदान करेगा
HR पेरोल कोरिया सार्वजनिक छुट्टियाँ एपीआई 2024 से 2027 तक की सार्वजनिक छुट्टियों को कवर करता है आप इन वर्षों में से किसी भी वर्ष के लिए छुट्टियों को उचित एंडपॉइंट का उपयोग करके पूछ सकते हैं
हाँ आप GET /holidays/{year}/{month} एंडपॉइंट का उपयोग 2024-2027 के वर्षों के भीतर किसी विशेष महीने के लिए छुट्टियों को पुनर्प्राप्त करने के लिए कर सकते हैं {year} और {month} को वांछित मानों से बदलें
"is_holiday" फ़ील्ड एक बूलियन मान है जो यह दर्शाता है कि तारीख एक सार्वजनिक छुट्टी है या नहीं यदि यह सत्य है तो तारीख को छुट्टी के रूप में मान्यता दी जाती है यदि यह असत्य है तो नहीं
वैकल्पिक छुट्टियाँ छुट्टी की सूची में शामिल हैं जिसमें "name" फ़ील्ड छुट्टी के नाम को दर्शाती है और "name_ko" फ़ील्ड कोरियाई नाम को दिखाती है "is_holiday" फ़ील्ड भी इन तारीखों के लिए सच होगा
यदि एपीआई एक विशेष महीने के लिए एक खाली array लौटाता है तो इसका मतलब है कि उस महीने में कोई सार्वजनिक अवकाश नहीं है आप अपने एप्लिकेशन में इस परिदृश्य को संभाल सकते हैं एक संदेश दिखाते हुए जो बताता है कि कोई छुट्टियां उपलब्ध नहीं हैं
एपीआई प्रतिक्रिया में "name" फ़ील्ड के माध्यम से छुट्टियों के नाम अंग्रेजी में लौटाता है सुनिश्चित करें कि आप इस फ़ील्ड को सही ढंग से अपने एप्लिकेशन में छुट्टियों के नाम प्रदर्शित करने के लिए पार्स करें
एपीआई डेटा को JSON प्रारूप में लौटाती है प्रत्येक प्रतिक्रिया में संरचित ऑब्जेक्ट शामिल होता है जिसमें "वर्ष" "मात्रा" और छुट्टियों के ऑब्जेक्ट्स की एक श्रृंखला होती है जो इसके विश्लेषण और अनुप्रयोगों में उपयोग को सरल बनाती है