맞춤형 API 상세

역사가 있는 여행 이야기

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2019/getConver10

  • 설명

    e뮤지엄 유물정보, 국립한글박문관 소장유물 정보등과 시티투어 데이터를 활용하여 역사적 가치가 있는 유물정보를 출토지나 소장기관과 활용하여 시티투어와 접목하는 서비스
    역사가 있는 여행 이야기

  • 기관명

    국립중앙박물관,국립한글박물관,한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Mar 2, 2020

    활용도

    4,913

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false
keyword string 검색어 false
where string 지역 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 rnum 번호
2 publisher 발행기관
3 creator 주된 책임을 진 개체
4 collectionDb 소속(통제)DB
5 title 자원의 명칭
6 subjectKeyword 핵심주제어(키워드)
7 referenceIdentifier 참조식별정보(썸네일이미지)
8 alternativeTitle 대체
9 extent 자원의 크기나 재생시간
10 medium 자원의물리적(물질적)상태
11 temporal 시간적범위
12 reference 참조한자원
13 rights 자원에 대한 권리
14 source 유래자원에 대한 참조
15 charge 요금 정보
16 venue 장소
17 time 시간
18 description 내용
19 subDescription 보조 서술
20 spatial 공간
21 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/convergence2019/getConver10"); /*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")); /*검색어*/
urlBuilder.append("&" + URLEncoder.encode("where","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/convergence2019/getConver10'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + encodeURIComponent('검색어'); /*검색어*/
queryParams += '&' + encodeURIComponent('where') + '=' + 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("rnum" + $(this).find("rnum").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("creator" + $(this).find("creator").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("title" + $(this).find("title").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("referenceIdentifier" + $(this).find("referenceIdentifier").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("extent" + $(this).find("extent").text());
console.log("medium" + $(this).find("medium").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("reference" + $(this).find("reference").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("charge" + $(this).find("charge").text());
console.log("venue" + $(this).find("venue").text());
console.log("time" + $(this).find("time").text());
console.log("description" + $(this).find("description").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("url" + $(this).find("url").text());

});

};

}
xhr.send('');