[JAVA] 영화 박스오피스 오픈 API (1) - 준비

서론

  이번 포스트에서는 영화진흥위원회(KOFIC)에서 제공하는 OPEN API를 이용하여 영화 박스오피스 데이터를 수집하는 인터페이스를 구축해볼 계획이다. 아주 간단하지만 재밌는 예제이고 유용하게 사용할 수 있다고 생각한다.

 

 

 

영화진흥위원회 오픈API

1. 홈페이지 소개

  - 영화진흥위원회 영화관입장권통합전산망에서 제공하는 오픈API 서비스.

  - 아래와 같은 데이터를 제공함

• 박스오피스 - 일일박스오피스, 주간/주말 박스오피스
• 영화정보 - 영화목록, 영화상세정보
• 영화사정보 - 영화사목록, 영화사상세정보
• 영화인정보 - 영화인목록, 영화인상세정보

  - 회원제 서비스이기 때문에 회원가입 후 이용할 수 있음.

 

  - www.kobis.or.kr/kobisopenapi/homepg/main/main.do

영화진흥위원회 오픈API

 

2. 회원가입

[ 이용약관 확인 후 '회원 가입 진행' ]

 

[ 개인정보 입력 후 '가입' ]

 

[ 가입확인하기! ]

 

[ '회원 인증 처리하러 가기' 버튼을 클릭하면 완료! ]

 

3. 키발급 하기

[ 키 발급/관리 탭으로 이동 ]

 

[ '키 발급받기' 버튼 클릭 ]

 

[ '사용 목적', '관리명' 입력 후 '키 발급' 클릭 ]

 

[ 키 발급 완료! ]

 

4. 박스오피스 API 정보

  - 요청URL

     http://www.kobis.or.kr/kobisopenapi/webservice/rest/boxoffice/searchDailyBoxOfficeList..json

 

  - 요청(Request) 인터페이스

요청변수	값	설명
key	문자열(필수)	발급받은키 값을 입력합니다.
targetDt	문자열(필수)	조회하고자 하는 날짜를 yyyymmdd 형식으로 입력합니다.
itemPerPage	문자열	결과 ROW 의 개수를 지정합니다.(default : “10”, 최대 : “10“)
multiMovieYn	문자열	다양성 영화/상업영화를 구분지어 조회할 수 있습니다. “Y” : 다양성 영화 “N” : 상업영화 (default : 전체)
repNationCd	문자열	한국/외국 영화별로 조회할 수 있습니다. “K: : 한국영화 “F” : 외국영화 (default : 전체)
wideAreaCd	문자열	상영지역별로 조회할 수 있으며, 지역코드는 공통코드 조회 서비스에서 “0105000000” 로서 조회된 지역코드입니다. (default : 전체)

 

  - 응답(Response) 구조

응답 필드	값	설명
boxofficeType	문자열	박스오피스 종류를 출력합니다.
showRange	문자열	박스오피스 조회 일자를 출력합니다.
rnum	문자열	순번을 출력합니다.
rank	문자열	해당일자의 박스오피스 순위를 출력합니다.
rankInten	문자열	전일대비 순위의 증감분을 출력합니다.
rankOldAndNew	문자열	랭킹에 신규진입여부를 출력합니다. “OLD” : 기존 , “NEW” : 신규
movieCd	문자열	영화의 대표코드를 출력합니다.
movieNm	문자열	영화명(국문)을 출력합니다.
openDt	문자열	영화의 개봉일을 출력합니다.
salesAmt	문자열	해당일의 매출액을 출력합니다.
salesShare	문자열	해당일자 상영작의 매출총액 대비 해당 영화의 매출비율을 출력합니다.
salesInten	문자열	전일 대비 매출액 증감분을 출력합니다.
salesChange	문자열	전일 대비 매출액 증감 비율을 출력합니다.
salesAcc	문자열	누적매출액을 출력합니다.
audiCnt	문자열	해당일의 관객수를 출력합니다.
audiInten	문자열	전일 대비 관객수 증감분을 출력합니다.
audiChange	문자열	전일 대비 관객수 증감 비율을 출력합니다.
audiAcc	문자열	누적관객수를 출력합니다.
scrnCnt	문자열	해당일자에 상영한 스크린수를 출력합니다.
showCnt	문자열	해당일자에 상영된 횟수를 출력합니다.

 

 

 

5. 예시URL

     http://www.kobis.or.kr/kobisopenapi/webservice/rest/boxoffice/searchDailyBoxOfficeList.json?key=430156241533f1d058c603178cc3ca0e&targetDt=20120101

[ 예시 데이터 ]

  - URL의 파라미터를 확인해보면, [ key=430156241533f1d058c603178cc3ca0e&targetDt=20120101 ] 요청 인터페이스 목록에 있는 key와 targetDt 가 사용된 것을 확인할 수 있음.

  - 추가로 itemPerPage, multiMovieYn, repNationCd, wideAreaCd 를 적용해보면 다양한 결과를 확인 할 수 있음.

 

 

 

 

 

마치며

  지금까지 영화진흥위원회 오픈API를 사용하기위해 회원가입을 하고 API 연계를 위한 인증키를 발급 받았다. 그리고, 박스오피스 정보를 요청할 때 필요한 정보와 응답받을 수 있는 데이터들도 확인해보았다. 다음 포스트에서는 JAVA 소스를 통해 데이터를 수집해보도록 하겠다.