공공데이터API - 한국천문연구원 특일 정보(공휴일, 국경일)

출처:  https://www.data.go.kr/tcs/dss/selectApiDataDetailView.do?publicDataPk=15012690

휴일정보를 주는 API를 찾던중 한국천문연구원에서 제공하는 특일 정보 API가 있어 살펴보았다

약국정보 운영시간중에 휴일인 경우 운영시간이 달라지기 때문인데

해당 API를 가지고 월별 휴일을 비교해서 휴일인경우만 체크해주면 간단할 것 같았기 때문이다

* 현재 공공데이터 포털 개편으로 테이블이 깨져보이는데..
개발자보기에서 contents.css 577라인에 있는 width: calc(100%-180px);
항목을 꺼버리면 테이블이 안깨지니 참고

---

제공되는 기능은 4가지

No	상세기능	설명	일일 트래픽
1	국경일 정보조회	월별로 구분(국경일), 요일, 공휴일 여부 등의 정보를 제공하는 국경일 및 공휴일 정보조회 기능	10000
2	공휴일 정보 조회	월별로 구분(휴일), 요일, 휴일 여부 등의 정보를 제공하는 공휴일 정보조회 기능	10000
3	24절기 정보 조회	월별로 구분(24절기), 요일, 공휴일 여부 등의 정보를 제공하는 24절기 정보 조회 기능	10000
4	잡절 정보 조회	월별로 구분(잡절), 요일, 공휴일 여부 등의 정보를 제공하는 잡절 정보 조회 기능	10000

잡절이 뭐지? 라는 생각과 공휴일, 국경일을 따로 분리한건가?

일단 돌려봐야 알것 같다

endPoint: http://apis.data.go.kr/B090041/openapi/service/SpcdeInfoService/

No	서비스명(국문)	서비스명(영문)
1	국경일정보조회	getHoliDeInfo
2	공휴일정보조회	getRestDeInfo
3	24절기정보조회	get24DivisionsInfo
4	잡절정보조회	getSundryDayInfo

 참고로... 늘 그렇듯 제공되는 문서와 조금씩 다르다...

문서에는 기념일도 있는데 문서상에는 설날, 추석 등으로 보인다...

---

테스트를 진행해보니

공휴일정보조회를 이용하면 전체(공휴일,국경일)를 조회할 수 있어보인다

그리고 문서에만 남아있는 기념일정보조회는 서비스가 삭제된게 맞는듯 하다

공공데이터API - 한국천문연구원 특일 정보(공휴일, 국경일)

---

1. 국경일 정보조회(getHoliDeInfo)

요청변수(Request Parameter)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
연	solYear	4	필수	2015	연
월	solMonth	2	필수	09	월

출력결과(Response Element)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode		필수	00	00:성공
결과메시지	resultMsg		필수		NORMAL SERVICE
날짜	locdate	8	필수	20150926	날짜
순번	seq		필수	1	같은 날짜에 두개 이상이 공휴일이 존재할 경우 카운팅 함
종류	dateKind	2	필수	01	공휴일, 잡절, 24기 종류에 따라 분류함
휴일여부	isHoliday	1	필수	Y	해당날짜가 휴일인지 아닌지 체크함
명칭	dateName	50	필수	삼일절	해당 날짜의 명칭
페이지당항목수	numOfRows		필수	10
페이지 수	pageNo		필수	1
모든항목수	totalCount		필수	16

 

요청항목에 월을 빼면 년도 전체를 반환해준다

하지만 어린이날, 추석등의 공휴일이 빠진 국경일만 조회된다

공공데이터API - 한국천문연구원 특일 정보(공휴일, 국경일)

---

2. 공휴일 정보 조회(getRestDeInfo)

요청변수(Request Parameter)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
연	solYear	4	필수	2015	연
월	solMonth	2	필수	09	월

출력결과(Response Element)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
날짜	locdate	8		20150301	날짜
순번	seq			1	순번
종류	dateKind	2		00	종류
공공기관 휴일여부	isHoliday	50		Y	공공기관 휴일여부
명칭	dateName	50		삼일절	명칭
페이지당항목수	numOfRows			10
페이지	pageNo			1
모든항목수	totalCount			210114

 

요청항목에 월을 빼면 년도 전체를 반환해준다

국경일을 포함한 전체 공휴일을 반환해주는듯 하다

요걸이용하면 공휴일에 해당하는 마스크 판매처 영업시간을 불러올수 있을것 같다

공공데이터API - 한국천문연구원 특일 정보(공휴일, 국경일)

---

3. 24절기 정보 조회(get24DivisionsInfo)

요청변수(Request Parameter)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
연	solYear	4	필수	2015	연
월	solMonth	2	필수	09	월

웹에서는 요청변수에 모든 항목수까지 표시되는데 에러인듯 하다

출력결과(Response Element)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
날짜	locdate	8		20150301	날짜
순번	seq			1	순번(날짜가 중복인지 체크하는 번호)
종류	dateKind	2		00	오퍼레이션별 구분 번호
공공기관 휴일여부	isHoliday	50		Y	공공기관 휴일여부
명칭	dateName	50		삼일절	명칭
한국표준시각	kst	10		0120	한국표준시각
태양황경	sunLongitude			285	태양황경
페이지당항목수	numOfRows			10
페이지	pageNo			1
모든항목수	totalCount			210114

---

4.잡절 정보조회(getSundryDayInfo)

요청변수(Request Parameter)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
연	solYear	4	필수	2015	연
월	solMonth	2	필수	09	월

출력결과(Response Element)

항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode		필수	00	00:성공
결과메시지	resultMsg		필수	NORMAL SERVICE
날짜	locdate	8	필수	20151021
순번	seq		필수	1	순번
종류	dateKind	2	필수	04	잡절, 공휴일, 24절기에 대한 분류
휴일여부	ishHoliday	1	필수	N	휴일여부(휴일일경우 Y)
명칭	dateName	50	필수	토왕용사	명칭
한국표준시각	kst	10	필수	2002	한국표준시각
태양황경	sunLongitude		필수	285	태양황경(도)
페이지당 항목 수	numOfRows		필수	10
페이지	pageNo		필수	1
모든항목수	totalCount		필수	2

 

참고

공공데이터 포탈: http://data.go.kr 

공공데이터 포털