자료공개센터

 
   

데이터API

문헌정보

고지도정보

 
 

문헌정보


한국학자료포털 고문헌 자료를 목록화 하고 문헌정보를 열람할 수 있는 API 형태는 다음과 같습니다.


1. 요청URL (request url)

http://kostma.aks.ac.kr/OpenAPI/request.aspx



2. 요청변수 (request parameter) - 목록

요청변수 설명
query string(필수): 세부검색을 항목 중 uci,subject, creator,publisher등에서 검사할 값을 지정합니다. UTF-8 인코딩입니다.
subquery와 동시 지정시 query 부분은 무시됩니다.
sub
query
uci string(선택): 한국학자료 uci 값
title string(선택): 한국학자료의 자료명을 대상으로 검색합니다.
subject string(선택): 한국학자료의 분류명을 대상으로 검색합니다.
publisher string(선택): 한국학자료의 관련인물을 대상으로 검색합니다.
date string(선택): 한국학자료의 작성시기(연도)를 기준으로 검색합니다.
page integer: 기본값 1 검색 결과 시작 페이지를 지정합니다.
ipp(item per page) integer : 기본값 10 한 페이지에 표시할 검색 결과 수를 지정합니다.
detail integer:기본값 0 (0,1,2)

결과 형태를 지정합니다.
0 : uci, 자료명, 자료의 URL을 출력
1 : 문헌정보에 포함된 기본정보 출력
2 : 문헌정보에 포함된 기본정보와 안내정보 출력

 

- TEST URL (한국학자료 중 자료명 또는 분류명에서 '고신'을 검색)
http://kostma.aks.ac.kr/OpenAPI/request.aspx?query=%EA%B3%A0%EC%8B%A0

 

3. 결과값 요소 (response element)

결과요소 설명
ksm element(필수): ksm 검색 결과물의 xml 최상의 root 요소입니다.
info
request string(필수): 질의 원본을 나타냅니다.
total string(필수): 질의에 대한 전체 검색 결과 수를 나타냅니다.
page string(필수): 현재 페이지 번호를 나타냅니다.
ipp string(필수): 한 페이지에 표시되는 검색 결과 수를 나타냅니다.

items

 /
item

uci string(필수): 한국학자료의 uci 값을 나타냅니다.
subject string(필수): 한국학자료의 분류를 나타냅니다.
title string(필수): 한국학자료의 자료명을 나타냅니다.
url string(선택): 한국학자료의 서비스 URL을 나타냅니다.

 

 


 

 경기도 성남시 분당구 하오개로 323 한국학중앙연구원 한국학학술정보관[463-791] 대표전화 : 031-781-5967
           Copyright the Academy of Korean Studies. All Rights Reserved.