안녕하세요. 그린주입니다 ๑'ٮ'๑
경험이 많이 부족하지만 최선을 다해 적어보겠습니다!
개요
이번 글에서는 공휴일 정보 조회 및 DB tb_holiday 저장하기 1편 - 활용 신청 방법을 공유하려고 합니다.
목차
공공데이터 포털 API
데이터 활용신청
공공데이터 포털 API
데이터 타이틀은 한국 천문연구원_특일 정보 아래 링크로 들어가시면 됩니다.
https://www.data.go.kr/data/15012690/openapi.do
한국천문연구원_특일 정보
(천문우주정보)국경일정보, 공휴일정보, 기념일정보, 24절기정보, 잡절정보를 조회하는 서비스 입니다. 활용시 날짜, 순번, 특일정보의 분류, 공공기관 휴일 여부, 명칭을 확인할 수 있습니다.
www.data.go.kr
OpenAPI 정보
REST API로 호출하여 XML 데이터 포맷을 받아 볼 수 있습니다.
요청 변수(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를 쉽게 구현할 수 있습니다.
데이터 활용신청
공휴일 API를 쓰기 위해서는 활용신청이 필요합니다.
아래와 같이 활용신청을 하게 되면 일일 트래픽으로 1만 건이 가능하고, 운영 계정으로 전환할 경우 10만 건까지 가능합니다.
| 서비스 종류 | 오퍼레이션명 | 설명 | 일일 트래픽 (개발) | 일일 트래픽 (운영) |
| 공휴일 정보조회 | getRestDeInfo | 월별로 구분(휴일), 요일, 휴일 여부 등의 정보를 제공하는 공휴일 정보조회 기능 | 10000건 |
10만건 |
1. 개발계정 신청
로그인 후 아래 활용신청으로 들어가 개발계정 신청서를 작성해줍니다.
활용신청이 완료되면 마이페이지에서 자동 승인된 처리상태와 부여받은 일반 인증키를 확인할 수 있습니다.
제공받은 인증키의 시스템 동기화 프로세스가 최대 1시간까지 소요될 수 있다고 합니다.
만약 "SERVICEKEY IS NOT REGIST ERROR" 오류가 발생한다면 기다렸다가 시도해주세요!
// 제공받은 인증키의 "SERVICEKEY IS NOT REGIST ERROR" 오류
<OpenAPI_ServiceResponse>
<cmmMsgHeader>
<errMsg>SERVICE ERROR</errMsg>
<returnAuthMsg>SERVICE_KEY_IS_NOT_REGISTERED_ERROR</returnAuthMsg>
<returnReasonCode>30</returnReasonCode>
</cmmMsgHeader>
</OpenAPI_ServiceResponse>이렇게 개발 계정 신청을 완료했습니다. 다음 운영 계정 신청 방법에 대해 알려드리겠습니다.
2. 운영 계정 신청
해당 데이터를 웹 혹은 모바일 앱에서 활용하고자 할 경우 운영 계정을 따로 신청해줘야 합니다.
운영 계정 신청은 개발계정 상세보기 맨 아래 운영 계정 신청 버튼이 있습니다.
운영 계정 신청 시 해당 데이터가 사용될 웹 혹은 모바일 앱에서 어떤 방식으로 활용되는지에 대한 활용사례 정보를 제출해야 합니다.
활용사례 정보로는 활용사례명, 개발 유형, 서비스 URL, 서비스 내용, 웹/앱 스크린샷 등입니다.
마무리
이렇게 공휴일 정보 조회 및 DB tb_holiday 저장하기 1편 - 활용신청 방법에 대해 알려드렸습니다.
- 2편은 "Open API 공휴일 정보 조회"로 샘플 코드를 활용하여 공휴일 정보를 조회하는 방법에 대한 내용입니다!
https://green-joo.tistory.com/8
Open API 공휴일 정보 조회 및 DB tb_holiday 저장하기 - 2. 공휴일 정보 조회 ( API / JAVA / XML / JSON )
안녕하세요. 그린주입니다 ๑'ٮ'๑ 경험이 많이 부족하지만 최선을 다해 적어보겠습니다! 개요 이번 글에서는 Open API 공휴일 정보 조회 및 DB tb_holiday 저장하기 - 2편 공휴일 정보 조회 방법을 공
green-joo.tistory.com
긴 글 봐주셔서 감사합니다!
오늘도 행복한 하루 보내세요 ✿'◡'✿
참고
https://zxchsr.tistory.com/148
https://m.blog.naver.com/wideeyed/221341051478
https://yogyui.tistory.com/entry/공공데이터포털공휴일-데이터-조회-REST-API
https://yusang.tistory.com/115