[2]. 공공데이터 포털 OpenAPI 사용 방법 - (1)

[2]. 공공데이터 포털 OpenAPI 사용 방법 - (1)

오늘은 공공데이터 포털의 OpenAPI의 사용법에 대한 글을 작성해보고자 한다.

공공데이터 포털은 지방재정 365 처럼 인증키를 1개만 발급 받으면 모든 데이터에 접근이 가능한 것은 아니지만 인증키 하나로 하나의 카테고리에 속해있는 여러게의 데이터에 접근이 가능하다.

이번 글에서는 사이트에 들어가서 인증키를 발급받는 방법과 OpenAPI의 접근 방법에 대하여 글을 적을 예정이고, 다음글에서는 실질적으로 R을 통하여 공공데이터 포털에서 데이터를 받아오는 코드에 대한 설명글을 적을 예정이다.

아래의 순서에 맞게 진행한다면 아주 쉽게 공공데이터 포털의 OpenAPI를 사용할 수 있을 것이다.

(1). 공공데이터 포털의 홈페이지에 접속한다.

(2).OpenAPI를 사용하기 위해서 먼저 사이트의 상단에 있는 "로그인" 버튼을 눌러 로그인을 한다.

(3).로그인 페이지에서 로그인을 한다.(비회원이라면 회원가입을 통하여 회원가입 후 로그인)

(4). 로그인 후 사이트의 상단 메뉴에 있는 "OpenAPI" 버튼을 누른다.

(5). "OpenAPI" 버튼을 누르면 아래와 같은 페이지로 이동한다.

(6). 이번 글에서는 활용신청건수가 가장 높은 국내 관광정보 서비스의 데이터를 살펴보기로 하자.

(7). 위에서 처럼 "국내 관광정보 서비스" 버튼을 누르면 아래와 같은 페이지로 이동한다.

(8). 한글로된 데이터를 사용하기 위한 인증키를 발급받기 위해서 국문 관광정보 서비스에 있는 "활용신청" 버튼을 누른다.

(9). "활용신청" 버튼을 누르면 아래와 같은 페이지로 이동한다.

(10). 스크롤바를 내리면 보이는 상세기능 정보에서 사용하고자 하는 데이터 유형의 체크박스를 누른 후 하단의 "신청" 버튼을 누른다.

(11). 아래와 같은 창이 보인다면 신청이 완료된 것이다. 창에서 "확인" 버튼을 누른다.

(12). "확인" 버튼을 누르면 아래와 같은 페이지로 이동하는데 여기서 조금 전 신청한 데이터 버튼을 눌러준다.

(13). 승인된 데이터 버튼을 누르면 아래와 같은 페이지로 이동한다.

(14). 페이지에서 발급받은 일반 인증키를 확인할 수 있다.

(15). 스크롤바를 내리면 보이는 상세기능정보에서 OpenAPI를 통해 데이터를 접근하고자 하는 데이터의 우측에 보이는 미리보기 다운로드 "실행" 버튼을 누른다.

(16). "실행"버튼을 누르면 해당 데이터 아래에 이와 같은 창이 추가적으로 생성된다. 여기서 "미리보기" 버튼을 누른다.

(17). "미리보기" 버튼을 누르면 새로운 창이 생기면서 아래와 같은 정보를 볼 수 있다.

(18). "미리보기" 버튼을 누르면 요청주소, 상세기능, 인증키가 포함된 Url 코드로 연결되는데 아래와 같다.

<요청 주소>

- 주소 : http://api.visitkorea.or.kr/openapi/service/rest/KorService/

<상세 기능>

- 행사 정보 조회 : searchFestival

<기본 인자>

- serviceKey : (14)번에서 확인 가능한 일반 인증키

미리보기 버튼을 누르면 생성되는 페이지 Url은 아래와 같다.

=> http://api.visitkorea.or.kr/openapi/service/rest/KorService/searchFestival?serviceKey=oooooooooooo

공공데이터 포털의 Url도 상세기능 뒤에는 ? 을 사용하여 기본인자 정보들을 적기 시작하고,

기본인자들 사이에는 &을 붙여서 구분지어 준다.

인증키가 사용된 Url임에도 불구하고 페이지에서는 INVALID REQUEST PARAMETER ERROR 이라는 에러로 인하여 데이터를 확인할 수 없는데

이는 Url에 들어가야할 필수 기본 인자들이 빠졌기 때문이다.

(19). 미리보기 Url에서 빠져있는 필수 기본 인자 정보

위의 미리보기 Url에서 빠져있는 기본 인자는 크게 4개이다.

- numOfRows : Url의 하나의 페이지에서 볼수있는 데이터의 개수

- pageNo : Url 페이지 번호

- MobileOS : 어느 모바일에서 사용할 건지 OS 구분

- MobileApp : 사용할 어플명, 활용통계를 산출하기 위한 항목(공공데이터 포털에서 필요한 항목)

이 빠져있는 필수 기본 인자들을 포함하여 다시 Url을 만들어보면 아래와 같다.

=> http://api.visitkorea.or.kr/openapi/service/rest/KorService/searchFestival?serviceKey=oooooooooooo&numOfRows=10&pageNo=1&MobileOS=ETC&MobileApp=TestApp

(20). 위에서 생성한 것과 같은 주소를 인터넷 주소 창에 입력한다.

위의 순서대로 따라하였다면 위의 그림과 같이 데이터에 접근하는 것을 성공하였을 것이다.

다음 글에서는 위에서처럼 xml 타입의 데이터를 R 을 통해서 실질적으로 가져오는 코드에 대한 설명을 해볼 예정이다.

끝