문화유산 상세

국립고궁박물관_ICT유물안내

기본정보

URL

http://api.kcisa.kr/openapi/service/rest/meta8/getGOGB3401
설명

국립고궁박물관의 유물안내 정보를 외부 개발자 및 사용자가 이를 활용 할 수 있도록 전달하는 API 서비스입니다. 유물의 명칭, 분류, 재질 등 유물에 대한 다양한 정보를 제공합니다.
제공기관

국립고궁박물관
API 키워드
서비스 분류
- 문화유산
- 공지및통계
- 공지
API유형

REST
API 등록일

2015-02-24

호출건수

653
데이터 수정일

갱신주기

연간

오픈 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	spatial	공간
11	temporal	시간적범위
12	person	사람
13	language	언어
14	sourceTitle	참조자원제목 (기존 = reference(참조한자원) + ' ' + source(유래자원에 대한 참조))
15	referenceIdentifier	참조식별정보(썸네일이미지)
16	rights	자원에 대한 권리
17	copyrightOthers	저작권
18	url	지식정보자원위치정보
19	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/meta8/getGOGB3401"); /*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/meta8/getGOGB3401'; /*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("spatial" + $(this).find("spatial").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("referenceIdentifier" + $(this).find("referenceIdentifier").text());
console.log("rights" + $(this).find("rights").text());
console.log("copyrightOthers" + $(this).find("copyrightOthers").text());
console.log("url" + $(this).find("url").text());
console.log("contributor" + $(this).find("contributor").text());

});

};

}
xhr.send('');

문화유산 상세

국립고궁박물관_ICT유물안내

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

샘플 데이터

샘플코드

연관 오픈API

국립중앙박물관_e뮤지엄 유물정보

문화재청_문화재사진정보

국립고궁박물관_ICT유물안내

대한민국역사박물관_발간자료

유네스코한국위원회_유네스코와유산

국립국악원_학술연구-국악이론

국립국악원_학술연구-구술채록

국립국악원_교육연구-국악사전

국립국악원_학술연구-해외보급자료

국립국악원_학술연구-국악원 논문집

국립국악원_학술연구-영인 번역

국립중앙박물관 외_문화교육의 시작

한국예술인복지재단_문화소식

국립중앙박물관 외_국립지방박물관 문화행사 통합정보

국립국악원_국악연감 서비스

국립중앙박물관 외_전시도록

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈API 오류신고