맞춤형 API 상세

한국의 향토문화

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2017/conver4

  • 설명

    우리문화의 원천인 전통문화에 대한 관심과 저변확대로 고유의 상징성을 나타내고 있음. 전국 230개 시ㆍ군ㆍ구 지역의 다양한 향토문화 자료인 고문헌자료를 시작으로 역사 속 인물의 상세정보, 민속놀이, 문화유산 정보를 제공합니다. 또한 우리만의 고유한 문양을 문화재, 유물 등으로부터 추출하여 산업적 디자인 소재로 활용이 가능한 한국의 문양을 포함하고 한스타일의 전통문화서비스를 제공
    한국의 향토문화

  • 기관명

    한국학중앙연구원,한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST+

  • 등록일

    2017-12-01

    활용도

    4,107

오픈 API

요청인자

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

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

false
pageNo string
페이지수

false
keyword string
검색어

false

출력 값

출력 값 상세표
No 변수명 출력설명
1 rn 번호
2 abstractDesc 자원의 대한 요약
3 affiliation 소속
4 alternativeTitle 대체
5 charge 요금 정보
6 collectionDb 소속(통제)DB
7 contributor 기여자
8 copyrightOthers 저작권
9 coverage 내용의범위
10 createdDate 제작일
11 creator 주된 책임을 진 개체
12 description 내용
13 digitalizedDate 디지털화 데이터
14 extent 자원의 크기나 재생시간
15 format 자원의 물리적, 디지털 구현형
16 grade 등급 정보
17 identifier 자원의식별
18 insertDate 자원이용일(수집일)
19 issuedDate 발행일
20 language 언어
21 medium 자원의물리적(물질적)상태
22 period 기간
23 person 사람
24 publisher 발행기관
25 reference 참조한자원
26 referenceIdentifier 참조식별정보(썸네일이미지)
27 regDate 등록일
28 relation 관련자원
29 rights 자원에 대한 권리
30 source 유래자원에 대한 참조
31 spatial 공간
32 subjectCategory 기관별주제분류체계
33 subjectKeyword 핵심주제어(키워드)
34 subDescription 보조 서술
35 tableOfContents 목차정보
36 temporal 시간적범위
37 time 시간
38 title 자원의 명칭
39 type 해당자원의 성격, 장르
40 uci 지식정보자원식별체계
41 url 지식정보자원위치정보
42 venue 장소

메시지 설명

메시지 설명 상세표
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/convergence2017/conver4"); /*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("keyword","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");
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/convergence2017/conver4'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + 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("rn" + $(this).find("rn").text());
console.log("abstractDesc" + $(this).find("abstractDesc").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("charge" + $(this).find("charge").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("contributor" + $(this).find("contributor").text());
console.log("copyrightOthers" + $(this).find("copyrightOthers").text());
console.log("coverage" + $(this).find("coverage").text());
console.log("createdDate" + $(this).find("createdDate").text());
console.log("creator" + $(this).find("creator").text());
console.log("description" + $(this).find("description").text());
console.log("digitalizedDate" + $(this).find("digitalizedDate").text());
console.log("extent" + $(this).find("extent").text());
console.log("format" + $(this).find("format").text());
console.log("grade" + $(this).find("grade").text());
console.log("identifier" + $(this).find("identifier").text());
console.log("insertDate" + $(this).find("insertDate").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("language" + $(this).find("language").text());
console.log("medium" + $(this).find("medium").text());
console.log("period" + $(this).find("period").text());
console.log("person" + $(this).find("person").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("reference" + $(this).find("reference").text());
console.log("referenceIdentifier" + $(this).find("referenceIdentifier").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("relation" + $(this).find("relation").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("tableOfContents" + $(this).find("tableOfContents").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("time" + $(this).find("time").text());
console.log("title" + $(this).find("title").text());
console.log("type" + $(this).find("type").text());
console.log("uci" + $(this).find("uci").text());
console.log("url" + $(this).find("url").text());
console.log("venue" + $(this).find("venue").text());

});

};

}
xhr.send('');