문화유산 상세

국립민속박물관_한국민속대백과사전

기본정보

URL

http://api.kcisa.kr/openapi/API_CHA_083/request
설명

국립민속박물관의 한국민속대백과사전은, 한국민속을 집대성하기 위한 전문백과사전으로 1) 한국 민속에 대한 총체적 설명을 제공하는 전문백과사전 편찬 2) 전통 문화에 대한 지식 체계 구축 및 민속 문화의 국내외 홍보 3) 급속히 사라져가는 민속에 대한 보존과 전승에 기여 하기 위한 목적으로 학습과 참조가 조화를 이룬 사전 및 멀티미디어의 질과 양에서 세계 최고의 전문백과사전으로 자리매김하여 사전학사에 표준 모델이 되는 사전을 제공합니다.
제공기관

국립민속박물관
API 키워드

한국,민속,전통문화,민속문화
서비스 분류
- 문화유산
- 무형유산
- 무형문화
API유형

REST
API 등록일

2024-12-27

호출건수

70
데이터 수정일

2025-02-28

갱신주기

상시

오픈 API

요청인자

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

출력 값

출력 값 상세표
No	변수명	출력설명
1	TITLE	제목
2	URL	URL
3	DESCRIPTION	소개(설명)
4	LOCAL_ID	ID
5	ISSUED_DATE	자료생성일자
6	FORMAT	자료형식
7	LANGUAGE	언어
8	ALTERNATIVE_TITLE	부제
9	SUBJECT_KEYWORD	키워드
10	AUTHOR	저자
11	CNTC_INSTT_NM	제공기관명

메시지 설명

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/API_CHA_083/request"); /*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/API_CHA_083/request'; /*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("URL" + $(this).find("URL").text());
console.log("DESCRIPTION" + $(this).find("DESCRIPTION").text());
console.log("LOCAL_ID" + $(this).find("LOCAL_ID").text());
console.log("ISSUED_DATE" + $(this).find("ISSUED_DATE").text());
console.log("FORMAT" + $(this).find("FORMAT").text());
console.log("LANGUAGE" + $(this).find("LANGUAGE").text());
console.log("ALTERNATIVE_TITLE" + $(this).find("ALTERNATIVE_TITLE").text());
console.log("SUBJECT_KEYWORD" + $(this).find("SUBJECT_KEYWORD").text());
console.log("AUTHOR" + $(this).find("AUTHOR").text());
console.log("CNTC_INSTT_NM" + $(this).find("CNTC_INSTT_NM").text());

});

};

}
xhr.send('');

문화유산 상세

국립민속박물관_한국민속대백과사전

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

샘플 데이터

샘플코드

연관 오픈API

국립민속박물관_민속대백과사전

한국문화정보원_전통문화종합사이트문화상징

국립민속박물관_한국민속대백과사전

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈API 오류신고