본문

Open API 개방목록

안내사항

오픈API 소개

오픈API란 누구나 사용할 수 있도록 공개된 API를 말합니다. 데이터를 표준화하고 프로그래밍해 외부 소프트웨어 개발자나 사용자들과 공유하는 프로그램입니다. 개방된 오픈API를 이용해 다양하고 재미있는 서비스나 애플리케이션, 다양한 형태의 플랫폼을 개발할 수 있습니다.

*API란?  Application Programming Interface의 약자로 응용 프로그램 프로그래밍 인터페이스를 말합니다. 다양한 응용 프로그램에 사용할 수 있는 운영 체제, 혹은 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스입니다.

오픈API(국가유산 정보조회 서비스) → 개발자 → 국가유산 정보 관련 앱 → 사용자
국가유산 앱개발

앱활용정보

참고사항
API 사용에 대한 참고사항입니다. 종목코드와 시도코드를 확인하세요
종목코드 11 : 국보   12 : 보물   13 : 사적   14 : 사적및명승   15 : 명승   16 : 천연기념물   17 : 국가무형유산   18 : 국가민속문화유산
21 : 시도유형문화유산   22 : 시도무형유산   23 : 시도기념물   24 : 시도민속문화유산   25 : 시도등록유산   31 : 문화유산자료
79 : 국가등록유산   80 : 이북5도 무형유산
시도코드 11 : 서울   21 : 부산   22 : 대구   23 : 인천   24 : 광주   25 : 대전   26 : 울산   45 : 세종   31 : 경기   32 : 강원   33 : 충북   34 : 충남   35 : 전북   36 : 전남   37 : 경북   38 : 경남   50 : 제주   ZZ : 전국일원
시군구코드
시군구 조회 OPEN API 목록 정보입니다.
OPEN API URL http://www.khs.go.kr/common/heritage/selectSearchGugunCdOpenApi.jsp
필수파라미터 ccbaCtcd(시도코드) / 데이터 타입 - String
※ 해당 표의 시도코드 참고하세요.
행사구분 01 : 문화재야행    02 : 생생국가유산   03 : 전통산사문화재    04 : 살아숨쉬는 향교·서원   07 : 국립무형유산원   08 : 한국문화재재단   09 : 고택·종갓집   10 : 세계유산   06 : 기타행사

국가유산 정보 OPEN API 현황
국가유산소식 OPEN API 목록 정보입니다.
종류 OPEN API URL
국가유산검색 목록 http://www.khs.go.kr/cha/SearchKindOpenapiList.do
※ 해당 목록은 해제된 국가유산도 포함하고 있습니다. *해제 국가유산에 대한 출력 여부는 하단 요청 파라미터 표를 참고하세요.
국가유산검색 상세
필수 파라미터 : ccbaKdcd, ccbaAsno, ccbaCtcd
국가유산검색 목록조회 : 요청 파라미터 (Request Parameter)
국가유산검색 목록조회 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 지정종목별
stCcbaAsdt int 지정연도 시작
enCcbaAsdt int 지정연도 끝
ccbaMnm1 String 국가유산명(국문)
ccbaCtcd String 시도코드
ccbaLcto String 시군구코드
※ 시도코드(ccbaCtcd) 필수
ccbaPcd1 String 시대
ccbaCpno String 국가유산연계번호
ccbaCncl String 지정해제여부 (Y, N)
pageUnit int 페이징 처리 시 페이지당 건 수
pageIndex int 조회할 페이지 숫자
stRegDt String 최종수정시작일시
enRegDt String 최종수정종료일시
샘플URL
http://www.khs.go.kr/cha/SearchKindOpenapiList.do?pageUnit=20&ccbaCncl=N&ccbaKdcd=11&ccbaCtcd=11
※ 해당 샘플URL은 요청파라미터 pageUnit, ccbaCncl, ccbaKdcd, ccbaCtcd를 활용한 URL입니다.

국가유산검색 목록조회 : 결과 파라미터 (Response Parameter)
국가유산검색 목록조회 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 조회된 총 데이터 건 수
pageUnit int 페이징 처리 시 페이지당 건 수
pageIndex int 조회할 페이지 숫자
sn int 순번
no int 고유 키값
ccmaName String 국가유산종목
ccbaMnm1 String 국가유산명(국문)
ccbaMnm2 String 국가유산명(한자)
ccbaCtcdNm String 시도명
ccsiName String 시군구명
ccbaAdmin String 관리자
ccbaKdcd String 종목코드
ccbaCtcd String 시도코드
ccbaAsno String 관리번호
ccbaCncl String 지정해제여부
ccbaCpno String 국가유산연계번호
longitude String 경도 ( 0일 경우 : 위치 값 없음 )
latitude String 위도 ( 0일 경우 : 위치 값 없음 )
regDt String 최종수정일시

국가유산검색 상세조회 : 요청 파라미터 (Request Parameter)
국가유산검색 상세조회 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 관리번호(필수)
ccbaCtcd String 시도코드(필수)

국가유산검색 상세조회 : 결과 파라미터 (Response Parameter)
국가유산검색 상세조회 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드
ccbaAsno String 관리번호
ccbaCtcd String 시도코드
ccbaCpno String 국가유산연계번호
longitude String 경도 ( 0일 경우 : 위치 값 없음 )
latitude String 위도 ( 0일 경우 : 위치 값 없음 )
ccmaName String 국가유산종목
gcodeName String 국가유산분류
bcodeName String 국가유산분류2
mcodeName String 국가유산분류3
scodeName String 국가유산분류4
ccbaQuan String 수량
ccbaAsdt String 지정(등록일)
ccbaLcad String 소재지 상세
ccceName String 시대
ccbaPoss String 소유자
ccbaAdmin String 관리자
imageUrl String 메인노출이미지URL
content String 내용

국가유산 정보 OPEN API 현황
국가유산소식 OPEN API 목록 정보입니다.
종류 OPEN API URL
국가유산 이미지검색 http://www.khs.go.kr/cha/SearchImageOpenapi.do
필수 파라미터 : ccbaKdcd, ccbaAsno, ccbaCtcd
국가유산 동영상검색 http://www.khs.go.kr/cha/SearchVideoOpenapi.do
필수 파라미터 : ccbaKdcd, ccbaAsno, ccbaCtcd
국가유산 나레이션검색 http://www.khs.go.kr/cha/SearchVoiceOpenapi.do
필수 파라미터 : ccbaKdcd, ccbaAsno, ccbaCtcd, ccbaGbn(value : kr/en/jpn/chn)
국가유산이미지검색 : 요청 파라미터 (Request Parameter)
국가유산이미지검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 관리번호(필수)
ccbaCtcd String 시도코드(필수)

국가유산이미지검색 : 결과 파라미터 (Response Parameter)
국가유산이미지검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 관리번호
ccbaCtcd String 시도코드
ccbaMnm1 String 국가유산명(국문)
ccbaMnm2 String 국가유산명(한자)
sn int 순번
imageNuri String 공공누리 타입
A : 제1유형, B : 제2유형, C : 제3유형, D : 제4유형

공공누리 유형안내 - https://www.kogl.or.kr/info/license.do
imageUrl String 메인노출이미지URL
ccimDesc String 이미지설명

국가유산동영상검색 : 요청 파라미터 (Request Parameter)
국가유산동영상검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 관리번호(필수)
ccbaCtcd String 시도코드(필수)

국가유산동영상검색 : 결과 파라미터 (Response Parameter)
국가유산동영상검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 관리번호
ccbaCtcd String 시도코드
ccbaMnm1 String 국가유산명(국문)
ccbaMnm2 String 국가유산명(한자)
sn int 순번
videoUrl String 동영상URL

국가유산나레이션검색 : 요청 파라미터 (Request Parameter)
국가유산나레이션검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 관리번호(필수)
ccbaCtcd String 시도코드(필수)
ccbaGbn String 국가구분(나레이션 검색 필수)
kr:국문, en:영문, jpn:일문, chn:중문

국가유산나레이션검색 : 결과 파라미터 (Response Parameter)
국가유산나레이션검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 관리번호
ccbaCtcd String 시도코드
ccbaMnm1 String 국가유산명(국문)
ccbaMnm2 String 국가유산명(한자)
sn int 순번
voiceUrl String 나레이션URL
국가유산 행사목록 : 요청 파라미터 (Request Parameter)
국가유산 행사목록 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
searchYear String 검색연도(필수)
searchMonth String 검색월(필수)
searchWrd String 행사명(선택)
siteCode String 행사구분(선택)
국가유산 행사목록 : 결과 파라미터 (response Parameter)
국가유산 행사목록 API 결과 파라미터 (response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
seqNo int 일련번호
siteCode String 행사구분
subTitle String 프로그램명
subContent String 프로그램내용
sDate String 시작일자
eDate String 종료일자
groupName String 그룹명
contact String 문의
subDesc String 장소
subPath String 경로
subDesc1 String 참여대상
subDesc2 String 기타
mainImageTemp String 이미지저장이름
sido String 시도
gugun String 시군구
subDate String 일정기간
fileNm String 상위노드(imgFile) : 이미지파일명
상위노드(downFile) : 첨부파일명
filePath String 상위노드(imgFile) : 이미지파일 경로
상위노드(downFile) : 첨부파일 경로
만족도조사
유용한 정보가 되셨나요?
만족도조사선택 확인
메뉴담당자 : 디지털정보담당관실
페이지상단 바로가기