DBpia OpenAPI - Open API - 이용가이드

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=Edge" /> <meta name="viewport" content="user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, width=device-width" /> <meta name="Keywords" content="논문, 전자저널, 학술논문, 전문잡지, 전자저널, 학술데이터베이스, 학술 데이터베이스, 학술DB, scholar, 학술지, 학술대회자료, 단행본" /> <meta name="Description" content="단행본, 학위논문, 학술지 논문, 학술대회 논문, 학회자료, 학회지 자료, 논문검색, 논문무료다운, 논문 다운로드. 논문다운로드, 학술논문검색, 학술논문 검색, 학술 논문 검색" /> <meta property="og:title" content="DBpia"/> <meta property="og:url" content="#"/> <title>DBpia OpenAPI - Open API - 이용가이드</title> <link rel="stylesheet" type="text/css" href="/css/common.css" /> <link rel="stylesheet" type="text/css" href="/css/sub.css" /> <link rel="stylesheet" type="text/css" href="/css/searchListBig.css" />    <script type="text/javascript" src="https://code.jquery.com/jquery-1.8.2.min.js"></script> <script type="text/javascript" src="/js/jquery.autotab-1.1b.js"></script> <script type="text/javascript" src="/js/menu.js"></script> <script type="text/javascript" src="/js/quick.js"></script> <script type="text/javascript" src="/js/jquery.popup.js"></script> <script type="text/javascript" src="/js/message.js"></script> </head> <body class="body-warp"> <div class="canvas-warp"> <div id="header"> <script type="text/javascript" src="/js/common.js" charset="utf-8"></script> <script type="text/javascript"> $(function () { $("._loginLayer").layerpopup({ name: 'loginLayer', b2bID: '', b2cID: '', loginType: '' }); }); </script> <form id="frmLogin" name="frmLogin"> <div class="top-warp"> <h1 class="top-logo"><a href="/openApi/index.do"><img src="/img/common/top_logo.jpg" alt="누리미디어" /><span class="hidden">누리미디어</span></a></h1>  <div class="top-navi-warp"> <span><a href="javascript:;" class="_loginLayer" targetVal="personal">로그인</a></span> <span class="blank">|</span> <span><a href="/openApi/member/memberAgree.do"> 회원가입</a></span> </div> </div> </form> <div class="top-menu-warp"> <ul> <li class="top-menu-depth1"> <a href="/openApi/about/intro.do" title="Open API"><img src="/img/common/topnavi_01.jpg" alt="Open API" /></a> <div class="top-menu-depth2"> <p><a href="/openApi/about/intro.do"><img src="/img/common/topnavi_02_01.jpg" alt="시작하기" /></a></p> <p><a href="/openApi/about/guide.do"><img src="/img/common/topnavi_02_02.jpg" alt="이용가이드" /></a></p> <p><a href="/openApi/about/search.do"><img src="/img/common/topnavi_02_03.jpg" alt="검색 API" /></a></p>   <p><a href="/openApi/about/bestthesis.do"><img src="/img/common/topnavi_02_06.jpg" alt="인기논문 API" /></a> <p><a href="/openApi/about/business.do"><img src="/img/common/topnavi_02_08.jpg" alt="비즈니스 API" /></a></p> </div> </li> <li class="top-menu-depth1"> <a href="#" onclick="javascript:alert('준비중입니다.'); return false;"><img src="/img/common/topnavi_02.jpg" alt="메뉴얼" /></a> </li> <li class="top-menu-depth1"> <a href="/openApi/Helpdesk/noticeList.do"><img src="/img/common/topnavi_03.jpg" alt="고객센터" /></a> <div class="top-menu-depth2 sz60"> <p><a href="/openApi/Helpdesk/noticeList.do"><img src="/img/common/topnavi_03_01.jpg" alt="공지사항" /></a></p> <p><a href="/openApi/Helpdesk/qnaList.do"><img src="/img/common/topnavi_03_02.jpg" alt="Q&A" /></a></p> </div> </li> </ul> </div> </div> <div id="content"> <div class="navi-warp a-none"> <a href="/openApi/index.do">홈</a> > <a href="/openApi/about/intro.do">Open API</a> > 이용가이드 </div> <div class="sub-warp">   <div class="sub-left"> <h3><img src="/img/sub/sub_title_01.jpg" alt="Open API" /><span class="hidden">Open API</span></h3> <div class="sub-menu"> <p > <a href="/openApi/about/intro.do">시작하기</a> </p> <p class="menu-on-one" > <a href="/openApi/about/guide.do">이용가이드</a> </p> <p > <a href="/openApi/about/search.do">검색 API</a> </p>  <p > <a href="/openApi/about/bestthesis.do">인기논문 API</a> </p> <p > <a href="/openApi/about/business.do">비즈니스 API</a> </p> </div> </div>  <div class="sub-contents mb40"> <div class="sub-title title-bar a-none"> <h3 class="title-left">이용가이드</h3> </div> <div class="contents-warp mt24"> <h3>1. DBpia Open API 개요</h3> <div class="contents_layer"> <h4>1.1 DBpia Open API 란?</h4> <div class="caption">DBpia 서비스를 외부에서 이용할 수 있도록 공개한 개발자 인터페이스로, 6가지 종류의 API를 제공하고 있습니다.</div> <dl class="layer_style_num mb20"> <dt class="num_depth1">(1) 검색 API</dt> <dd class="line_bar">전자저널, 전자책, 웹DB, 참고자료∙사전, 첫단추 등 DBpia의 다양한 콘텐츠를 검색할 수 있습니다.</dd>  <dt class="num_depth1">(2) 인기논문 API</dt> <dd class="line_bar">인기 논문 검색 - 최근 1개월 기준 단위로 이용순위가 높은 인기논문 정보를 제공받을 수 있습니다.</dd> <dt class="num_depth1">(3) 비즈니스 API</dt> <dd class="line_bar">DBpia에서 제공하는 학술저널, 전자책, 웹DB, 참고자료∙사전 등 다양한 콘텐츠의 상세정보를 제공받을 수 있습니다.</dd> <dd class="line_bar">검색 API와 연동하여 사용하면 검색서비스와 함께 상세정보 서비스도 동시에 할 수 있습니다.</dd> </dl> <div class="caption mb20">누리미디어 오픈 API 플랫폼 개발을 위해서는 회원 등록 후 API 키를 발급받아야 합니다. 검색 API 키를 발급받으면 모바일 API를 동시에 사용할 수 있지만 비즈니스 API는 별도의 키가 필요합니다.</div> </div> <div class="contents_layer"> <h4>1.2 DBpia Open API 종류</h4> <dl class="layer_style_num"> <dt class="num_depth1">(1) 검색 API</dt> <dd class="line_bar">자료유형 선택 : 질의어 검색시 전자저널, 전자책, 웹DB, 참고자료∙사전 등 자료유형을 선택하여 그 자료유형에 해당되는 정보만 검색할 수 있습니다.</dd> </dl> </div> <div class="caption mb05 text-right">[검색 옵션]</div> <div class="form-layout mb30"> <dl class="list-style mb10"> <dt class="tr"> <p class="date03">기능</p> <p class="title06">설명</p> </dt> <dd class="td"> <p class="date03">질의어 검색</p> <p class="cont01"> 전체 통합검색 뿐만 아니라 저자명, 간행물명, 발행기관명을 검색할 수 있습니다.<br/> 또한 질의어, 저자명, 간행물명, 발행기관명을 조합한 상세검색 기능도 지원합니다.<br/><br/> 예) ‘한국’이라는 질의어가 들어간 논문 중, ‘김누리’가 작성하고 ‘한국누리학회지’에 실린 논문을 보고 싶을 때<br/> → 큰 검색창에는 ‘한국’, 저자 검색창에는 ‘김누리’, 간행물 검색창에는 ‘한국누리학회지’를 입력하여 검색 가능합니다. </p> </dd> <dd class="td"> <p class="date03">주제분류 선택</p> <p class="cont01"> 질의어 검색시 특정 주제분류를 선택하여 그 주제분류에 해당되는 정보만 검색할 수 있습니다. <br/> 주제분류는 인문학, 사회과학, 자연과학, 공학, 의약학, 농수해양학, 예술체육, 복합학, 교양 중에서 선택할 수 있습니다. </p> </dd> <dd class="td"> <p class="date03">자료유형 선택</p> <p class="cont01"> 질의어 검색시 학술저널, 학술대회자료, 전문잡지, 연구보고서 등 자료유형을 선택하여 그 자료유형에 해당되는 정보만 검색할 수 있습니다. </p> </dd> <dd class="td"> <p class="date03">발행연도 선택</p> <p class="cont01"> 질의어 검색시 발행연도를 설정하여 검색할 수 있습니다.<br/> 발행연도는 시작연도, 종료연도를 설정하거나, 최근 1년, 최근 3년 단위로 지정할 수도 있습니다. </p> </dd> </dl> <div class="caption">[참고] 질의어는 필수 입력항목입니다. 따라서 주제분류, 자료유형, 발행연도 선택시 적어도 하나의 질의어는 입력되어야 합니다.</div> </div>  <div class="contents_layer"> <dl class="layer_style_num">  <dt class="num_depth1">(2) 인기논문 API</dt> <dd class="line_bar">인기논문 API를 사용하면 최근 1개월 단위로 이용순위가 높은 인기논문 정보를 제공받을 수 있습니다.</dd> <dd class="line_bar">인기논문은 인문학, 사회과학, 자연과학, 공학, 의약학, 농수해양학, 예술체육, 복합학, 교양 등 9개 주제분야별로 선택하여 제공받을 수 있습니다.</dd> <dd class="line_bar">인기논문의 기준은 논문 다운로드수입니다.</dd> <dt class="num_depth1">(3) 비즈니스 API</dt> <dd class="line_bar">DBpia에서 제공하는 학술저널, 전자책, 웹DB, 참고자료∙사전 등 다양한 콘텐츠의 상세정보를 제공할 수 있습니다.</dd> <dd class="line_bar">검색 API와 연동하여 사용하면 검색 서비스와 함께 상세정보 서비스도 동시에 할 수 있습니다.</dd> </dl> </div> <h3>2. API 사용방법</h3> <div class="contents_layer"> <h4>1.1 Open API 구동방식</h4> <div class="caption pb10">누리미디어 Open API는 웹프로토콜(HTTP)로 호출되어 XML로 결과값을 전달합니다. 따라서 Open API를 사용하는 애플리케이션은 웹프로토콜을 이용하여 특정 URL로 요청을 전송하고, 서버로부터 전달되는 XML결과를 파싱해야 합니다. 예를 들어 검색 API에서 검색결과를 요청하는 Open API의 URL은 다음과 같습니다.</div> <div class="caption pb10 b"><span class="color-blue">http://api.dbpia.co.kr/v2/search/search.xml?key=0000&target=se&searchall=library</span></div> <div class="caption">위의 URL을 웹브라우저로 보면 다음과 같습니다.</div> <dl> <dd class="img_area"><img src="/img/openapi/img_guide_smp01.jpg" alt="요청URL을 웹브라우저로 보았을 때" /></dd> </dl> <h4>1.2. 요청 URL</h4> <dl class="layer_style_num mb20"> <dt class="num_depth1">http://api.dbpia.co.kr/v2/search/search.xml</dt> <dd class="line_bar">? 앞까지가 URL이며, URL은 API의 종류에 따라 다릅니다.</dd> </dl> <h4>1.3. 요청 변수</h4> <div class="caption"> 서버에 전송해야 하는 값으로, 오청 URL 뒤에 변수명과 값을 “name=value” 형식으로 명시하며 요청변수가 많으면 ‘&’로 구분합니다. 요청변수에는 반드시 명시해야 하는 기본 요청변수와 선택적 요청변수가 있습니다.</div> <dl class="layer_style_num mb10"> <dt class="num_depth1">1.3.1. 기본 요청 변수</dt> <dd class="mb10">누리미디어 검색 Open API의 경우 다음 3가지 요청변수는 필수사항입니다.</dd> <dd class="line_bar">key : 누리미디어 DBpia Open API 키 등록/관리 페이지에서 등록한 키값입니다. (앞의 예제에서 key로 사용한 0000은 예제이므로 사용할 수 없습니다.)</dd> <dd class="line_bar">target : 앞에서 target을 se로 설정했는데, 이것은 검색 API를 지시하는 것이고 API 종류마다 다른 변수명을 사용해야 합니다.</dd> <dd class="line_bar">searchall : 검색어를 명시합니다.</dd> </dl> <div class="caption">기본 요청변수를 지정하지 않으면 다음과 같은 오류 메시지가 XML로 반환됩니다.</div> <dl> <dd class="img_area"><img src="/img/openapi/img_guide_smp02.jpg" alt="오류메시지" /></dd> </dl> <dl class="layer_style_num mb10"> <dt class="num_depth1">1.3.2. 선택 요청 변수</dt> <dd class="mb10">Open API 호출시 전송화지 않으면 기본값이 사용되며 API는 문제없이 동작합니다. 선택 요청변수에는 다음과 같은 것들이 있습니다.</dd> <dd class="line_bar">상세검색 요청변수 : 저자명, 간행물명, 발행기관명을 검색하거나, 자료유형별, 주제분야별로 세분화해서 검색할 때, 또는 발행연도를 지정하여 검색할 때 사용합니다.</dd> <dd class="line_bar">필터 요청변수 : 유료 콘텐츠만 검색할지, 무료 콘텐츠를 포함할지 여부와 공공학술정보(첫단추)를 포함할지 여부를 설정합니다</dd> <dd class="line_bar">결과 페이지 구성 및 정렬 요청변수 : 페이지당 검색결과건수, 페이지 번호, 정렬유형을 설정합니다.</dd> </dl> <h4>1.4. 예제</h4> <div class="caption">검색 API 에서 ‘library’라는 검색어로 사회과학 자료만 검색할 경우 호출 URL 구성은 다음과 같습니다.</div> <dl class="layer_style_num mb10"> <dd class="line_bar">요청 URL : http://api.dbpia.co.kr/v2/search/search.xml</dd> <dd class="line_bar">기본 요청변수 : key=각자의 API 키, target=se, searchall=library</dd> <dd class="line_bar">선택 요청변수 : category=2</dd> </dl> <div class="caption pb10">이를 조합한 최종 URL은 다음과 같습니다.</div> <div class="caption pb10 b"><span class="color-blue">http://api.dbpia.co.kr/v2/search/search.xml?key=0000&target=se&searchall=library&category=2</span></div> <div class="caption">각각의 API에 대해서는 각 해당 페이지를 참고하십시오.</div> </div> </div> </div>  <div id="quickMenu" class="top-btn-warp"> <a href="javascript:goTop();"><img src="/img/sub/TOP_btn.jpg" alt="top" /></a> <p><a href="javascript:goTop();">TOP</a></p> </div>  </div> </div> <div id="footer">  <div class="footerWrap"> <div class="inner"> <ul class="ftTop"> <li class="menu"><a href="/openApi/about/copyrightPolicy.do" target="_blank" title="새창열림">저작권정보</a></li> <li class="menu"><a href="/openApi/about/agreement.do" target="_blank" title="새창열림">이용약관</a></li> <li class="menu"><a href="/openApi/about/privacyPolicy.do" target="_blank" title="새창열림"><span class="f-bold">개인정보처리방침</span></a></li> <li class="menu"><a href="/openApi/about/disclaimer.do" target="_blank" title="새창열림">책임의 한계와 고지</a></li> </ul> <div class="family"> <button id="spreadBtn02" type="button" class="open" title="유관사이트 닫기">유관사이트</button> <ul id="hiddenList01" class="scrollbar"> <li><a href="http://www.nurimedia.co.kr" target="_blank" title="새창열림">누리미디어</a></li> <li><a href="http://www.dbpia.co.kr" target="_blank" title="새창열림">DBpia</a></li> <li><a href="http://krpia.co.kr" target="_blank" title="새창열림">KRpia</a></li> </ul> </div>  <script> $(document).ready(function(){ $("#spreadBtn02").click(function(){ if($("#hiddenList01").is(":visible")){ $("#hiddenList01").slideUp(); }else{ $("#hiddenList01").slideDown(); } }); }); </script>  </div> <div class="inner topline"> <ul class="ftBottom"> <li>㈜누리미디어 대표이사: 최순일 사업자등록번호: 816-81-00840</li> <li><span>통신판매업신고번호: 제2017-서울영등포-0801호 </span><span><button class="business_info" type="button">사업자정보확인</button></span></li> <li><span>주소: (03994) 서울특별시 마포구 양화로19길 22-16</span></li> <div class="copy"> <p class="copyright">Copyright (c) 1997-2024 NURIMEDIA. ALL RIGHTS RESERVED.</p> </div> </ul> <div class="bnWrap"> <ul class="banner"> <li><a href="javascript:openWindow('/img/common/isms-kr.jpg', 471, 639)" class="isms-p"></a></li> <li><a href="https://aws.amazon.com/ko/what-is-aws/?nc1=f_cc" target="_blank" class="aws"></a></li> </ul> </div> </div> </div>  <script> function openWindow (page, x, y){ opWindow = window.open('','Links','width='+x+', height='+y+', tollbar=0, scrollbars=0, resizable=no'); if(opWindow != null){ if (opWindow.opener == null){ opWindow.opener = self; } opWindow.location.href=page; } } $(document).on('click', '.business_info', function(){ window.open("http://www.ftc.go.kr/bizCommPop.do?wrkr_no=8168100840", "bizCommPop", "width=750, height=700;"); }) </script>  <div id="loginLayer"> <form name="LoginForm" id="LoginForm" method="post" action="/openApi/login/loginProc.do"> <div class="boxs"> <ul class="loginLayer_message" style="display: none;"> <li>개인회원으로 로그인하셔야 이용이 가능합니다.</li> </ul> <ul class="inputbox"> <li> <img src="/img/common/login_id.jpg" alt=""> <input type="text" id="login_userId" name="login_userId" class="input_txt" title="아이디" value="" maxlength="16" style="ime-mode:inactive" > </li> <li> <img src="/img/common/login_pw.jpg" alt=""> <input type="password" id="login_passWd" name="login_passWd" class="input_txt" title="비밀번호" maxlength="13" onkeydown="javascript:if(event.keyCode==13)fnLogin();" > <div class="loginbtn"> <div><img src="/img/common/btn_login.jpg" style="cursor:pointer;" onclick="javascript:fnLogin();" alt=""></div> </div> </li> </ul> <ul class="loginLayer_error"><li></li></ul> <ul class="loginLayer_personal" style="display: block;"> <li>ㆍ개인회원가입으로 더욱 편리하게 이용하세요.<a href="/openApi/member/memberAgree.do" class="loginLayer_joinLink"><img src="/img/common/join_01.jpg" alt=""></a></li> <li>ㆍ아이디를 잊으셨나요?<a href="/openApi/member/memberFind.do"><img src="/img/common/findID.jpg" alt=""></a></li> <li>ㆍ비밀번호를 잊으셨나요?<a href="/openApi/member/memberFind.do"><img src="/img/common/findPW.jpg" alt=""></a></li> </ul> </div> </form> </div>  </div> </div> </body> </html>

CINXE.COM

DBpia OpenAPI - Open API - 이용가이드