콘텐츠 허브
- 기타
- 신규
- 무료
- 고유번호
- 1561
- 최근 업데이트
- 2026.08.24 07:08
- 누적 다운로드
- 2회
- [그누보드5] 한국천문연구원 특일정보 API 달력 페이지 공유합니다
- 공공데이터포털의 한국천문연구원 특일 정보 OpenAPI를 활용한 그누보드5용 별도 달력 페이지입니다. 국경일·공휴일·기념일·24절기·잡절을 월별 달력과 목록으로 확인할 수 있으며, 반응형을 지원합니다.
파일 다운로드
무료로 다운로드 할 수 있습니다.라이선스 정책
https://www.data.go.kr/data/15012690/openapi.do
API 키 미설정 오류가 5개 분류별로 반복되던 문제 수정
전체 조회에서 일부 API만 실패해도 경고가 표시되도록 수정
사이트에서 API 키 저장 시 실제 API 연결로 인증키 유효성 검사
인증키 저장 성공 시 기존 캐시 자동 삭제
새 캐시에는 인증키 해시를 기록하여 잘못된 키가 기존 캐시에 가려지는 문제 보완
v1.0.12 이하 캐시는 최초 1회 API를 다시 확인한 뒤 새 형식으로 갱신
달력 마지막 주 뒤쪽 빈칸까지 채워서 그리드가 중간에서 끊겨 보이는 문제 수정
specialday.settings.php에 키가 없어도 기존 config.php의 API 키로 자동 fallback
신형/구형 설정파일의 제목·캐시시간 등 기존 설정도 계속 호환
공공데이터 API의 별도 인증 오류 XML 응답도 감지하도록 보강
SimpleXML이 없는 서버에서는 Fatal Error 대신 원인을 표시
User-Agent 버전 1.0.13으로 갱신
기존 모바일 크기 수정 / 제목 수정 / MONTHLY LIST 5개 페이징 / 중복 제거 유지
실제 사용자 API 설정파일은 ZIP에 포함하지 않아 기존 키 보존
전체 조회에서 일부 API만 실패해도 경고가 표시되도록 수정
사이트에서 API 키 저장 시 실제 API 연결로 인증키 유효성 검사
인증키 저장 성공 시 기존 캐시 자동 삭제
새 캐시에는 인증키 해시를 기록하여 잘못된 키가 기존 캐시에 가려지는 문제 보완
v1.0.12 이하 캐시는 최초 1회 API를 다시 확인한 뒤 새 형식으로 갱신
달력 마지막 주 뒤쪽 빈칸까지 채워서 그리드가 중간에서 끊겨 보이는 문제 수정
specialday.settings.php에 키가 없어도 기존 config.php의 API 키로 자동 fallback
신형/구형 설정파일의 제목·캐시시간 등 기존 설정도 계속 호환
공공데이터 API의 별도 인증 오류 XML 응답도 감지하도록 보강
SimpleXML이 없는 서버에서는 Fatal Error 대신 원인을 표시
User-Agent 버전 1.0.13으로 갱신
기존 모바일 크기 수정 / 제목 수정 / MONTHLY LIST 5개 페이징 / 중복 제거 유지
실제 사용자 API 설정파일은 ZIP에 포함하지 않아 기존 키 보존
상세정보
공공데이터포털의 한국천문연구원 특일 정보 OpenAPI 를 활용하여 만든 그누보드5용 별도 달력 페이지입니다.
플러그인 방식이 아니며, 그누보드5에 `specialday` 폴더를 추가하여 독립 페이지 형태로 사용할 수 있습니다.
간략설명
국경일·공휴일·기념일·24절기·잡절을 월별 달력으로 확인할 수 있으며, 최고관리자는 페이지 내 API 설정에서 공공데이터포털 인증키를 직접 등록·수정할 수 있습니다.
반응형, API 캐시 및 기존 버전 설정 호환을 지원합니다.
주요 기능
- 국경일
- 공휴일
- 기념일
- 24절기
- 잡절
- 전체 특일 통합 조회
- 이전달 / 다음달 이동
- 연도·월 직접 선택
- 종류별 필터
- 동일 날짜·동일 명칭 중복 제거
- 공휴일 여부 표시
- 월별 일정 목록
- MONTHLY LIST 5개씩 표시
- 페이지 번호 방식 목록 이동
- PC 달력 우측 MONTHLY LIST 배치
- 모바일 반응형
- API 응답 캐시
- 별도 DB 테이블 설치 없음
- 관리자 메뉴 강제 추가 없음
API 설정
최고관리자로 로그인한 뒤 `specialday` 페이지에 접속하면 API 설정 버튼이 표시됩니다.
해당 메뉴에서 공공데이터포털에서 발급받은 API 인증키를 입력하고 저장하면 됩니다.
API 키를 PHP 파일에 직접 입력할 필요가 없습니다.
저장된 API 설정은 배포 파일과 별도로 관리되므로 이후 새 버전을 덮어써도 기존 API 인증키가 초기화되지 않습니다.
기존 버전의 설정파일을 사용하고 있는 경우에도 기존 API 키를 읽을 수 있도록 호환되어 있습니다.
설치 방법
압축파일을 해제한 뒤 `specialday` 폴더를 그누보드5가 설치된 경로에 업로드합니다.
예시
`사이트/specialday/`
설치 후 아래 주소로 접속합니다.
https://사이트주소/specialday/
최고관리자로 접속하여 API 설정에서 인증키를 등록하면 사용할 수 있습니다.
사용 공공데이터
데이터명
한국천문연구원_특일 정보
제공기관
한국천문연구원
제공정보
국경일정보 / 공휴일정보 / 기념일정보 / 24절기정보 / 잡절정보
API 유형
REST
데이터 포맷
XML
공공데이터포털
https://www.data.go.kr/data/15012690/openapi.do
이용 조건 및 라이선스 정보
공공데이터포털에 등록된 해당 OpenAPI의 이용 조건입니다.
* 비용부과유무: 무료
* 이용허락범위: 제한 없음
* 개발단계 활용승인: 자동승인
* 운영단계 활용승인: 자동승인
* 개발계정 신청 가능 트래픽: 10,000건
* 운영계정: 활용사례 등록 후 신청 시 트래픽 증가 가능
※ 위 이용 조건은 공공데이터포털의 `한국천문연구원_특일 정보` OpenAPI에 명시된 내용을 기준으로 합니다.
※ 본 자료는 한국천문연구원의 공식 프로그램이 아니며, 공개된 OpenAPI를 그누보드5에서 조회할 수 있도록 별도로 제작한 페이지입니다.
버전
V 1.3 (내부 : v1.0.13
현재 개인적으로 사용하면서 수정하고 있으며, 환경에 따라 차이가 있을 수 있습니다.
오류나 개선할 부분이 있다면 댓글로 알려주시면 확인해보겠습니다.
화련 님의 콘텐츠가 도움이 되셨다면
잊지말고 추천 해주세요!
잊지말고 추천 해주세요!