맞춤형 API 상세

도서정보조회 서비스

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2017/conver7

  • 설명

    국민의 지식 정보 접근성을 높이고 생활 친화적 도서 문화 향상을 위한 종합 도서 정보 및 학술연구정보 검색서비스 제공. 유형별,주제별 소장원문과 가치있는 정보자원을 큐레이션 하여 서비스 (한국의 위대한 인물, 시대별 전쟁사, 잡지창간호 등) 또한 이용자들의 관심을 반영한 시의성 있는 테마를 제공하고 도서관의 현황 및 학술지의 소장기관정보를 서비스 (전국대학 및 전문도서관 좌표정보, 학술지 통계정보조회)
    도서정보조회 서비스

  • 기관명

    한국문학번역원,국립중앙도서관,한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Dec 1, 2017

    활용도

    3,339

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false
keyword string 검색어 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 rn 번호
2 title 자원의 명칭
3 description 내용
4 abstractDesc 자원의 대한 요약
5 affiliation 소속
6 alternativeTitle 대체
7 charge 요금 정보
8 collectionDb 소속(통제)DB
9 contributor 기여자
10 coverage 내용의범위
11 createdDate 제작일
12 creator 주된 책임을 진 개체
13 extent 자원의 크기나 재생시간
14 format 자원의 물리적, 디지털 구현형
15 grade 등급 정보
16 venue 장소
17 spatial 공간
18 temporal 시간적범위
19 time 시간
20 identifier 자원의식별
21 issuedDate 발행일
22 medium 자원의물리적(물질적)상태
23 period 기간
24 person 사람
25 reference 참조한자원
26 referenceIdentifier 참조식별정보(썸네일이미지)
27 relation 관련자원
28 rights 자원에 대한 권리
29 source 유래자원에 대한 참조
30 subjectCategory 기관별주제분류체계
31 subjectKeyword 핵심주제어(키워드)
32 subDescription 보조 서술
33 tableOfContents 목차정보
34 uci 지식정보자원식별체계
35 url 지식정보자원위치정보
36 copyrightothers 저작권
37 digitalizedDate 디지털화 데이터
38 insertDate 자원이용일(수집일)
39 language 언어
40 publisher 발행기관
41 regDate 등록일
42 type 해당자원의 성격, 장르
43 email 이메일
44 zipCode 우편번호
45 position 위도, 경도
46 issn 그자체(국제 표준 연속 간행물 번호 - 8자리 고유번호)

메시지 설명

메시지 설명 상세표
0000 정상 처리
F2013 서비스 주소 호출 실패
9999 서비스 점검중(내부 서비스 호출 장애)

활용 명세

샘플 데이터

>샘플 데이터 상세

샘플코드

/* 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/service/rest/convergence2017/conver7"); /*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")); /*페이지수*/
urlBuilder.append("&" + URLEncoder.encode("keyword","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");
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/service/rest/convergence2017/conver7'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + 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("rn" + $(this).find("rn").text());
console.log("title" + $(this).find("title").text());
console.log("description" + $(this).find("description").text());
console.log("abstractDesc" + $(this).find("abstractDesc").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("charge" + $(this).find("charge").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("contributor" + $(this).find("contributor").text());
console.log("coverage" + $(this).find("coverage").text());
console.log("createdDate" + $(this).find("createdDate").text());
console.log("creator" + $(this).find("creator").text());
console.log("extent" + $(this).find("extent").text());
console.log("format" + $(this).find("format").text());
console.log("grade" + $(this).find("grade").text());
console.log("venue" + $(this).find("venue").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("time" + $(this).find("time").text());
console.log("identifier" + $(this).find("identifier").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("medium" + $(this).find("medium").text());
console.log("period" + $(this).find("period").text());
console.log("person" + $(this).find("person").text());
console.log("reference" + $(this).find("reference").text());
console.log("referenceIdentifier" + $(this).find("referenceIdentifier").text());
console.log("relation" + $(this).find("relation").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("tableOfContents" + $(this).find("tableOfContents").text());
console.log("uci" + $(this).find("uci").text());
console.log("url" + $(this).find("url").text());
console.log("copyrightothers" + $(this).find("copyrightothers").text());
console.log("digitalizedDate" + $(this).find("digitalizedDate").text());
console.log("insertDate" + $(this).find("insertDate").text());
console.log("language" + $(this).find("language").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("type" + $(this).find("type").text());
console.log("email" + $(this).find("email").text());
console.log("zipCode" + $(this).find("zipCode").text());
console.log("position" + $(this).find("position").text());
console.log("issn" + $(this).find("issn").text());

});

};

}
xhr.send('');