Open API 개방목록
- 안내사항
-
오픈API 소개
오픈API란 누구나 사용할 수 있도록 공개된 API를 말합니다. 데이터를 표준화하고 프로그래밍해 외부 소프트웨어 개발자나 사용자들과 공유하는 프로그램입니다. 개방된 오픈API를 이용해 다양하고 재미있는 서비스나 애플리케이션, 다양한 형태의 플랫폼을 개발할 수 있습니다.
*API란? Application Programming Interface의 약자로 응용 프로그램 프로그래밍 인터페이스를 말합니다. 다양한 응용 프로그램에 사용할 수 있는 운영 체제, 혹은 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스입니다.
국가유산 앱개발
참고사항
| 종목코드 | 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 : 전국일원 | ||||
| 시군구코드 |
|
||||
| 행사구분 | 01 : 문화재야행 02 : 생생국가유산 03 : 전통산사문화재 04 : 살아숨쉬는 향교·서원 07 : 국립무형유산원 08 : 한국문화재재단 09 : 고택·종갓집 10 : 세계유산 06 : 기타행사 |
국가유산 정보 OPEN API 현황
| 종류 | OPEN API URL |
|---|---|
| 국가유산검색 목록 | http://www.khs.go.kr/cha/SearchKindOpenapiList.do
※ 해당 목록은 해제된 국가유산도 포함하고 있습니다. *해제 국가유산에 대한 출력 여부는 하단 요청 파라미터 표를 참고하세요.
|
| 국가유산검색 상세 |
필수 파라미터 : ccbaKdcd, ccbaAsno, ccbaCtcd
|
국가유산검색 목록조회 : 요청 파라미터 (Request 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)
| 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)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| ccbaKdcd | String | 종목코드(필수) |
| ccbaAsno | String | 관리번호(필수) |
| ccbaCtcd | String | 시도코드(필수) |
국가유산검색 상세조회 : 결과 파라미터 (Response 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 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)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| ccbaKdcd | String | 종목코드(필수) |
| ccbaAsno | String | 관리번호(필수) |
| ccbaCtcd | String | 시도코드(필수) |
국가유산이미지검색 : 결과 파라미터 (Response 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)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| ccbaKdcd | String | 종목코드(필수) |
| ccbaAsno | String | 관리번호(필수) |
| ccbaCtcd | String | 시도코드(필수) |
국가유산동영상검색 : 결과 파라미터 (Response Parameter)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| totalCnt | int | 전체갯수 |
| ccbaKdcd | String | 종목코드 |
| ccbaAsno | String | 관리번호 |
| ccbaCtcd | String | 시도코드 |
| ccbaMnm1 | String | 국가유산명(국문) |
| ccbaMnm2 | String | 국가유산명(한자) |
| sn | int | 순번 |
| videoUrl | String | 동영상URL |
국가유산나레이션검색 : 요청 파라미터 (Request Parameter)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| ccbaKdcd | String | 종목코드(필수) |
| ccbaAsno | String | 관리번호(필수) |
| ccbaCtcd | String | 시도코드(필수) |
| ccbaGbn | String | 국가구분(나레이션 검색 필수) kr:국문, en:영문, jpn:일문, chn:중문 |
국가유산나레이션검색 : 결과 파라미터 (Response Parameter)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| totalCnt | int | 전체갯수 |
| ccbaKdcd | String | 종목코드 |
| ccbaAsno | String | 관리번호 |
| ccbaCtcd | String | 시도코드 |
| ccbaMnm1 | String | 국가유산명(국문) |
| ccbaMnm2 | String | 국가유산명(한자) |
| sn | int | 순번 |
| voiceUrl | String | 나레이션URL |
국가유산 행사목록 : 요청 파라미터 (Request Parameter)
| Parameter | 데이터타입 | 내용 |
|---|---|---|
| searchYear | String | 검색연도(필수) |
| searchMonth | String | 검색월(필수) |
| searchWrd | String | 행사명(선택) |
| siteCode | String | 행사구분(선택) |
국가유산 행사목록 : 결과 파라미터 (response 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) : 첨부파일 경로 |
메뉴담당자 : 디지털정보담당관실
