Service
한국천문연구원 특일 정보 서비스(SpcdeInfoService)를 정규화한 대한민국 특일 캘린더로, 공휴일·국경일·기념일·24절기·잡절을 제공합니다.
99.89%30일 가동률평균 응답170ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-holiday/anniversaries | Lists Korean memorial and commemorative anniversaries for a solar year or month via KASI getAnniversaryInfo. Use when building cultural or civic calendars of observances that are usually NOT automatic days off. Do NOT use for public holidays or payroll closed-day logic — use korea-holiday:public-holidays and filter is_public_institution_holiday instead. Returns ISO dates, official names, kind, remarks when present, and paging totals (total_count, page, limit). Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. | |
| POST | /v1/korea-holiday/national-days | Lists the full KASI getHoliDeInfo calendar for a solar year or month: every public holiday (including substitute, election, and temporary holidays) plus statutory national days that are not days off, such as Constitution Day (제헌절). It is a superset of korea-holiday:public-holidays and differs only by those non-rest rows; in years without such rows the two are identical. Use when you need national days that are not days off alongside the holiday calendar. Do NOT use for closed-day decisions — use korea-holiday:public-holidays instead, or filter is_public_institution_holiday here. Returns ISO dates, official names, kind, and is_public_institution_holiday. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. | |
| POST | /v1/korea-holiday/public-holidays | Lists South Korean public institution holidays for a solar year or month via KASI getRestDeInfo, including substitute holidays and election days. Use when checking whether banks, schools, or government offices are closed on a Korean calendar day, or when building a year-wide holiday schedule. Do NOT use for solar terms or for memorial anniversaries that are not days off — use korea-holiday:solar-terms or korea-holiday:anniversaries instead. Lunar-calendar conversion is not supported. Returns ISO dates, official Korean names, kind, is_public_institution_holiday, and the upstream total_count with page and limit. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. | |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST |
| /v1/korea-holiday/solar-terms |
| Lists the 24 solar terms for a solar year or month via KASI get24DivisionsInfo, including the KST event clock time and sun longitude when upstream provides them. Use for traditional seasonal markers such as Ipchun or Dongji in Korean almanac contexts. Do NOT use for public holidays or institution closed days — solar terms are usually not holidays; use korea-holiday:public-holidays instead. Returns ISO dates, names, event_time_kst (HH:MM), and sun_longitude_degrees. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. |
| POST | /v1/korea-holiday/traditional-days | Lists traditional miscellaneous Korean calendar days (잡절) such as Hansik or Dano for a solar year or month via KASI getSundryDayInfo. Use for cultural almanac features that go beyond national holidays. Do NOT use as a closed-day calendar — use korea-holiday:public-holidays for institution holidays instead. Returns ISO dates, official names, kind, and is_public_institution_holiday. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. |
