한국학자료센터 OpenAPI 소개

한국학자료센터 자료공개센터에서는 한국학자료센터(kostma.aks.ac.kr)에서 서비스하는 고문헌자료의 데이터 및 서비스 기능들을 Open API(Application Programming Interface)로 제공하고 있습니다. 각 권역에서 구축한 고문헌자료의 문헌정보와 고문서자료관의 문헌정보는 데이터 API에서 이용하며, 고지도정보도 데이터API에서 이용합니다. 한국학자료포털 서비스인 디렉토리서비스, 용례사전서비스 등은 서비스API에서 이용할 수 있습니다.
Open API 결과의 형태는 XML(eXtensible Markup Language)이며 서비스 API의 경우 XML과 XSL(eXtensible Stylesheet Language)이 적용된 형태 등 두 가지 방식으로 열람할 수 있습니다.

데이터 API

문헌정보

한국학자료의 문헌정보(기본정보, 안내정보)를 목록화하여 열람할 수 있습니다. 결과 자료는 해당 자료의 URL, 기본정보, 기본정보와 안내정보 등 세가지 방식의 XML로 제공합니다.

고지도정보

고지도(동여도)에 나타난 고지명을 검색하고 고지도를 볼 수 있습니다. 결과 자료는 고지명에 해당하는 고지명ID, 고지명한글, 고지명한자, 현재주소, 고지도의 URL을 XML로 제공합니다.

서비스 API

디렉토리서비스

한국학자료의 디렉토리 분류정보(유형/주제/소장처/지역/시기)를 열람할 수 있으며 서비스 형태는 다음과 같습니다.

1) 디렉토리 트리(분류) 서비스

- 디렉토리 분류정보(유형,주제,소장처,지역,시기)의 대분류별 중분류(트리) 정보를 열람할 수 있으며 디렉토리 분류별 전체코드 목록보기가 제공됩니다.

2) 디렉토리 분류 서비스(하위노드)

- 디렉토리 분류정보(유형,주제,소장처,지역,시기)별 하위 분류정보를 열람할 수 있으며 디렉토리 분류별 전체코드 목록보기가 제공됩니다.

3) 디렉토리 검색 서비스

- 한국학자료 디렉토리 분류코드로 자료를 검색하여 디렉토리별 자료목록을 XML 또는 XSL이 적용된 형태로 열람할 수 있습니다.

용례사전서비스

디지털 고문헌사전, 디지털 고문헌용어사전 등을 열람할 수 있으며 서비스 형태는 다음과 같습니다.

1) 용례사전 트리(분류) 서비스

- 한국학자료 용례사전의 분류정보를 XML로 열람할 수 있습니다.

2) 용례사전 목록(가,나,다...) 서비스

- 한국학자료 용례사전의 표제어 목록(가,나,다..)을 XML 또는 XSL이 적용된 형태로 열람할 수 있습니다.

3) 용례사전 내용보기 서비스

- 한국학자료 용례사전의 내용을 항목ID로 검색하면 용례사전의 내용을 열람할 수 있는 페이지의 URL을 XML로 제공합니다.