문화유산 상세

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

기본정보

URL

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

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

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

REST
API 등록일

2015-02-24

호출건수

654
데이터 수정일

갱신주기

연간

오픈 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=] 를 추가하여 호출하시기 바랍니다.

샘플 데이터

>샘플 데이터 상세
자원의 명칭	대체 (기존 = alternativeTitle(대체) + ' ' + subTitle(부제))	주된 책임을 진 개체	등록일	소속(통제)DB	기관별주제분류체계	자원의 크기나 재생시간	내용 (기존 = description(내용) + ' ' + abstract(자원의 대한 요약))	언어	참조식별정보(썸네일이미지)	지식정보자원위치정보
옥제연리문쌍이잔		홈페이지	2021-01-06 01:04:12	소장품및왕실문화 아카이브정보	유물 > 기타	최대폭: 9cm, 높이: 5.4cm	<p><span style=font-size: 10pt; font-weight: bold;>제작년도: </span><span style=font-size: 10pt;>18세기<br></span><span style=font-size: 10pt;><br>조선 영 · 정조 때 문신인 황인점과 그의 부인 화유옹주의 합장묘 부장품이다. 화유옹주(和柔翁主, 1740 ~ 1777)는 영조의 열 번째 딸로 1753년 창성위(昌城尉) 황인점과 혼인하였다. 옹주는 왕의 후궁이 낳은 딸을 말하며 외명부(外命婦)에 속한다. 출토유물은 생전에 사용하던 것들로 옥제 비녀 13점, 금동제 비녀 5점, 기타 도자기 등 총 30점이 넘는다. 이 중 일부 도자기는 황인점이 청나라에 다녀오면서 가져온 것들로 추정된다. 이들 유물은 18세기 조선의 궁중과 양반들의 실생활을 알 수 있는 중요한 자료들로 평가된다. 1991년 6월 경기도 부천시 도로확장공사로 인한 묘이장 작업 중 발견</span><span style=font-size: 10pt;> </span><span style=font-size: 10pt;>· </span><span style=line-height: 1.2; font-size: 10pt;>출토되었으며, 황인점의 8대 종손 황선욱씨가 우리 관에 기증한 것이다.<br>\n<br>옥으로 만든 쌍이잔(雙耳盞)이다. 손잡이에 동물 형상이 양각되어 있고, 표면에 연리문(練理紋)이 확인된다.</span></p>	kor	http://www.gogung.go.kr/culture/getImage.do?cultureSeq=00017104PN&imgSeq=5	http://www.gogung.go.kr/searchView.do?cultureSeq=00017104PN
청화백자합	靑華白磁盒	홈페이지	2021-01-06 01:04:12	소장품및왕실문화 아카이브정보	유물 > 도자기	폭: 5.6cm, 높이: 3.3cm	<p class=0><span style=font-weight: bold;>제작년도:</span> 18세기<br>\n<br>\n조선 영 · 정조 때 문신인 황인점과 그의 부인 화유옹주의 합장묘 부장품이다. 화유옹주(和柔翁主, 1740 ~ 1777)는 영조의 열 번째 딸로 1753년 창성위(昌城尉) 황인점과 혼인하였다. 옹주는 왕의 후궁이 낳은 딸을 말하며 외명부(外命婦)에 속한다. 출토유물은 생전에 사용하던 것들로 옥제 비녀 13점, 금동제 비녀 5점, 기타 도자기 등 총 30점이 넘는다. 이 중 일부 도자기는 황인점이 청나라에 다녀오면서 가져온 것들로 추정된다. 이들 유물은 18세기 조선의 궁중과 양반들의 실생활을 알 수 있는 중요한 자료들로 평가된다. 1991년 6월 경기도 부천시 도로확장공사로 인한 묘이장 작업 중 발견 · 출토되었으며, 황인점의 8대 종손 황선욱씨가 우리 관에 기증한 것이다.<br>\n<br>\n아담한 크기의 백자합이다. 표면에 청화 안료를 사용하여 당초 무늬를 시문하였다.<br>\n<br></p>	kor	http://www.gogung.go.kr/culture/getImage.do?cultureSeq=00017105RE&imgSeq=5	http://www.gogung.go.kr/searchView.do?cultureSeq=00017105RE
청화백자잔	靑華白磁盞	홈페이지	2021-01-06 01:04:12	소장품및왕실문화 아카이브정보	유물 > 도자기	입지름: 5cm, 밑지름: 2cm, 높이: 3.8cm	<p><span style=font-weight: bold;>제작년도:</span> 18세기<br>\n<br>\n조선 영 · 정조 때 문신인 황인점과 그의 부인 화유옹주의 합장묘 부장품이다. 화유옹주(和柔翁主, 1740 ~ 1777)는 영조의 열 번째 딸로 1753년 창성위(昌城尉) 황인점과 혼인하였다. 옹주는 왕의 후궁이 낳은 딸을 말하며 외명부(外命婦)에 속한다. 출토유물은 생전에 사용하던 것들로 옥제 비녀 13점, 금동제 비녀 5점, 기타 도자기 등 총 30점이 넘는다. 이 중 일부 도자기는 황인점이 청나라에 다녀오면서 가져온 것들로 추정된다. 이들 유물은 18세기 조선의 궁중과 양반들의 실생활을 알 수 있는 중요한 자료들로 평가된다. 1991년 6월 경기도 부천시 도로확장공사로 인한 묘이장 작업 중 발견 · 출토되었으며, 황인점의 8대 종손 황선욱씨가 우리 관에 기증한 것이다.<br>\n<br>\n아담한 크기의 청화백자잔이다. 구연은 밖으로 벌어졌으며, 굽은 좁고 낮은 형태이다. 잔의 표면에 청화 안료를 사용하여 풀무늬를 간결하게 그려 넣었다. <br>\n<br>\n<br></p>	kor	http://www.gogung.go.kr/culture/getImage.do?cultureSeq=00017106UV&imgSeq=4	http://www.gogung.go.kr/searchView.do?cultureSeq=00017106UV
'비·이'자문 목판	？·爾字紋木板	홈페이지	2021-01-06 01:04:12	소장품및왕실문화 아카이브정보	유물 > 조각	가로: 3.7, 세로: 3.3, 높이: 2.9	<span>\n<p>상서롭고 운이 좋은 것을 상징하는 구절인 길상어문(吉祥語文)이다. 《시경詩經》이나 《예기禮記》 등의 고서에 나오는 구절을 복식의 깃이나 고름, 선단 부분에 부금(付金)하여 착용자의 무병장수와 부귀영화를 기원하였다. 왕실 아동에게 주로 사용되었다.<br>\n<br>양면에 각각 '비(俾)'자와 '이(爾)'자가 양각된 목판이다. 장수와 번영을 기원한다는 뜻인 '비이치이창 비이수이장(俾爾熾而昌俾爾壽而臧)' 등의 구절에 사용했을 것으로 보인다. 목판 한 면에 '칠(七)' 이라는 묵서가 있다.</p></span>	kor	http://www.gogung.go.kr/culture/getImage.do?cultureSeq=00011154TM&imgSeq=4	http://www.gogung.go.kr/searchView.do?cultureSeq=00011154TM
화조도	花鳥圖	홈페이지	2021-01-06 01:04:12	소장품및왕실문화 아카이브정보	유물 > 회화	족자 세로: 214.6cm, 가로: 63.7cm \| 화면 세로: 131.5cm, 가로: 47.6cm	<p class=0><span style=font-weight: bold;>제작년도</span><span style=letter-spacing: 0pt; font-family: 함초롬바탕;><span style=font-weight: bold;>:</span> </span>조선<br>\n<span style=line-height: 1.2; font-size: 10pt; font-weight: bold;>유형</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;><span style=font-weight: bold;>:</span> </span><span style=line-height: 1.2; font-size: 10pt;>족자<br></span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;><br>선명하고 짙은 색채로 그려진 화조도이다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>. </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>두 폭이 한 점을 이룬다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>. </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>두 폭 모두 다른 종류의 새 두 쌍과 여러 가지 꽃들로 구성되었으며 흙으로 만든 둑과</span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;> 괴석이 큰 비중을 차지한다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>. </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>두 폭의 화면 구성 방식에 같은 원칙을 적용하여 둑과</span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;> 괴석을 화면 한쪽에 치우치게 배치하고 화려한 깃털을 가진 새 한 쌍은 지면 혹은 괴석에 </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>다른 한 쌍의 새는 위쪽으로 뻗어 올라간 꽃가지 위에 배치하는 방식을 취하였다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>. </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>새를 표현한 섬세한 필치와 화려하면서도 깊이감 있는 색채가 돋보인다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>. </span><span style=line-height: 1.2; letter-spacing: 0pt; font-size: 10pt;>본래 여러 폭으로 구성된 병풍으로 제작되었으나 후대에 낱폭으로 분리된 것으로 추정된다</span><span style=line-height: 1.2; letter-spacing: 0pt; font-family: 함초롬바탕; font-size: 10pt;>.</span></p>\n<p class=0><span style=font-family: 한컴바탕;> </span></p>	kor	http://www.gogung.go.kr/culture/getImage.do?cultureSeq=00017087CI&imgSeq=2	http://www.gogung.go.kr/searchView.do?cultureSeq=00017087CI

샘플코드

/* 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 오류신고