문화산업 상세

KOBIS_주간주말_박스오피스

  • URL

    http://api.kcisa.kr/openapi/service/rest/meta16/getkobis02

  • 설명

    영화진흥위원회의 영화관입장권 통합전산망(KOBIS)에서 제공하는 주간/주말 박스오피스 정보를 외부 개발자 및 사용자가 이를 활용 할 수 있도록 전달하는 API 서비스입니다. 각 날짜별 작품의 매출액, 순위, 상영 횟수 등 다양한 박스오피스정보를 제공합니다.

  • 기관명

    영화진흥위원회

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST@

  • 데이터 등록일

    2020-05-14

    호출건수

    1,211

  • 데이터 수정일

    2020-12-11

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string
서비스키

true
numOfRows string
세션당 요청레코드수

false
pageNo string
페이지수

false
weekgb string
검색유형(0:주간(월~일), 1:주말(금~일), 2:주중(월~목))

true
date string
검색날짜(YYYYMMDD)

true

출력 값

출력 값 상세표
No 변수명 출력설명
1 title 자원의 명칭
2 creator 주된 책임을 진 개체
3 temporal 시간적범위
4 alternativeTitle 대체 (기존 = alternativeTitle(대체) + ' ' + subTitle(부제))
5 issuedDate 발행일
6 collectionDb 소속(통제)DB
7 state 상태
8 grade 등급 정보
9 description 내용 (기존 = description(내용) + ' ' + abstract(자원의 대한 요약))
10 subDescription 보조 서술
11 language 언어
12 url 지식정보자원위치정보

메시지 설명

메시지 설명 상세표
0000 정상 처리
F2013 서비스 주소 호출 실패
9999 서비스 점검중(내부 서비스 호출 장애)

활용 명세

샘플 데이터

>샘플 데이터 상세

샘플코드

/* Java Sample */
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.io.BufferedReader;
import java.io.IOException;

public class openApi {
public static void main(String[] args) throws IOException {

StringBuilder urlBuilder = new StringBuilder("http://api.kcisa.kr/openapi/service/rest/meta16/getkobis02"); /*URL*/
urlBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*서비스키*/
urlBuilder.append("&" + URLEncoder.encode("numOfRows","UTF-8") + "=" + URLEncoder.encode("세션당 요청레코드수", "UTF-8")); /*세션당 요청레코드수*/
urlBuilder.append("&" + URLEncoder.encode("pageNo","UTF-8") + "=" + URLEncoder.encode("페이지수", "UTF-8")); /*페이지수*/
urlBuilder.append("&" + URLEncoder.encode("weekgb","UTF-8") + "=" + URLEncoder.encode("검색유형(0:주간(월~일), 1:주말(금~일), 2:주중(월~목))", "UTF-8")); /*검색유형(0:주간(월~일), 1:주말(금~일), 2:주중(월~목))*/
urlBuilder.append("&" + URLEncoder.encode("date","UTF-8") + "=" + URLEncoder.encode("검색날짜(YYYYMMDD)", "UTF-8")); /*검색날짜(YYYYMMDD)*/

URL url = new URL(urlBuilder.toString());
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

conn.setRequestMethod("GET");
conn.setRequestProperty("Content-type", "application/json");
System.out.println("Response code: " + conn.getResponseCode());

BufferedReader rd;
if(conn.getResponseCode() >= 200 && conn.getResponseCode() <= 300) {

rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));

} else {

rd = new BufferedReader(new InputStreamReader(conn.getErrorStream()));

}

StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {

sb.append(line);

}
rd.close();
conn.disconnect();
System.out.println(sb.toString());

}

}
/* Javascript Sample*/
var xhr = new XMLHttpRequest();
var url = 'http://api.kcisa.kr/openapi/service/rest/meta16/getkobis02'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('weekgb') + '=' + encodeURIComponent('검색유형(0:주간(월~일), 1:주말(금~일), 2:주중(월~목))'); /*검색유형(0:주간(월~일), 1:주말(금~일), 2:주중(월~목))*/
queryParams += '&' + encodeURIComponent('date') + '=' + encodeURIComponent('검색날짜(YYYYMMDD)'); /*검색날짜(YYYYMMDD)*/

xhr.open('GET', url + queryParams);
xhr.onreadystatechange = function () {
if (this.readyState == 4) {

console.log('status: ' + this.status);
console.log('resultCode: ' + $(this.responseText).find('resultCode').text());
console.log('resultMsg: ' + $(this.responseText).find('resultMsg').text());

var item = $(this.responseText).find('item');
$(item).each(function(){

console.log("title" + $(this).find("title").text());
console.log("creator" + $(this).find("creator").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("state" + $(this).find("state").text());
console.log("grade" + $(this).find("grade").text());
console.log("description" + $(this).find("description").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("language" + $(this).find("language").text());
console.log("url" + $(this).find("url").text());

});

};

}
xhr.send('');