문화산업 상세

한국영상자료원_비디오정보

기본정보

URL

http://api.kcisa.kr/openapi/service/rest/meta/KFAvide
설명

한국영상자료원의 비디오정보를 외부 개발자 및 사용자가 이를 활용 할 수 있도록 전달하는 API 서비스입니다. 제목, 관람기준, 상영시간 등 다양한 정보를 제공합니다.
제공기관

한국영상자료원
API 키워드
서비스 분류
- 문화산업
- 창작물
- 영화/영상
API유형

REST
API 등록일

2014-10-22

호출건수

314
데이터 수정일

2025-05-22

갱신주기

연간

오픈 API

요청인자

서비스키
- 변수명serviceKey
- 타입string
- 필수여부true
세션당 요청레코드수
- 변수명numOfRows
- 타입string
- 필수여부false
페이지수
- 변수명pageNo
- 타입string
- 필수여부false

출력 값

출력 값 상세표
No	변수명	출력설명
1	title	자원의 명칭
2	alternativeTitle	대체 (기존 = alternativeTitle(대체) + ' ' + subTitle(부제))
3	creator	주된 책임을 진 개체
4	regDate	등록일
5	collectionDb	소속(통제)DB
6	subjectCategory	기관별주제분류체계
7	subjectKeyword	핵심주제어(키워드)
8	extent	자원의 크기나 재생시간
9	description	내용 (기존 = description(내용) + ' ' + abstract(자원의 대한 요약))
10	spatialCoverage	관련장소 (기존 = spatial(공간) + ' ' + venue(장소))
11	temporal	시간적범위
12	person	사람
13	language	언어
14	sourceTitle	참조자원제목 (기존 = reference(참조한자원) + ' ' + source(유래자원에 대한 참조))
15	rights	자원에 대한 권리
16	copyrightOthers	저작권
17	uci	지식정보자원식별체계
18	contributor	기여자

메시지 설명

0000
정상 처리
F2013
서비스 주소 호출 실패
9999
서비스 점검중(내부 서비스 호출 장애)

활용 명세

※ parameter(조회조건)에 numOfRow, pageNo 외의 다른 조건이 있을 경우, 빈 값이더라도 다음 샘플과 같이 공백인 조건을 포함하여 [(샘플)&keyword=] 를 추가하여 호출하시기 바랍니다.

샘플 데이터

샘플코드

/* 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/meta/KFAvide"); /*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")); /*페이지수*/

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

conn.setRequestMethod("GET");
conn.setRequestProperty("Content-type", "application/json");
//json type으로 응답받고 싶을 때는 아래 주석을 제거하시고 사용바랍니다.
//conn.setRequestProperty("Accept","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/meta/KFAvide'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/

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("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("creator" + $(this).find("creator").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("extent" + $(this).find("extent").text());
console.log("description" + $(this).find("description").text());
console.log("spatialCoverage" + $(this).find("spatialCoverage").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("person" + $(this).find("person").text());
console.log("language" + $(this).find("language").text());
console.log("sourceTitle" + $(this).find("sourceTitle").text());
console.log("rights" + $(this).find("rights").text());
console.log("copyrightOthers" + $(this).find("copyrightOthers").text());
console.log("uci" + $(this).find("uci").text());
console.log("contributor" + $(this).find("contributor").text());

});

};

}
xhr.send('');

문화산업 상세

한국영상자료원_비디오정보

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

샘플 데이터

샘플코드

연관 오픈API

한국영상자료원_포스터정보

한국영상자료원_영화정보

한국영상자료원_상영정보

영화진흥위원회_영화정보

한국영상자료원_동영상정보

한국영상자료원_비디오정보

한국영상자료원_스틸정보

한국영상자료원_시나리오정보

영화진흥위원회_박스오피스

영상물등급위원회 외_무비갤러리

영상물등급위원회_영화 등급분류 목록

한국문화정보원_전국 아동서점 운영정보

영상물등급위원회_비디오정보 서비스

한국영상자료원_D시네마 정보 서비스

한국영상자료원_전단지정보

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈API 오류신고