Open API
인기논문 API를 통해 최근 1개월 단위로 이용순위가 높은 인기논문 정보를 제공받을 수 있습니다.
- 1. 요청 URL (request url)
- 2. 요청 변수
-
요청변수
값
설명
-
key
string(필수)
발급받은 API 키를 입력합니다.
-
target
string(필수):rated_art
인기논문 API 서비스를 위해서는 무조건 입력해야 합니다.
-
pyear
integer
원하는 연도의 인기논문을 지정합니다.
입력하지 않으면 전월의 인기논문을 검색합니다. -
pmonth
integer
원하는 월의 인기논문을 지정합니다.
※ pyear를 입력하면 반드시 pmonth를 입력해야 합니다. pmonth를 입력하지 않으면 전월의 인기논문을 검색합니다. -
category
string
주제분류별로 검색할 때 입력합니다. 입력하지 않으면 모든 주제분류를 검색합니다.
1=인문학 | 2=사회과학 | 3=자연과학 | 4=공학 | 5=의약학
6=농수해양 | 7=예술체육 | 8=복합학 | 9=교양
- 2. 출력 결과 필드
- 2.1 출력 요약정보
-
필드
값
설명
-
totalcount
integer
전체 검색결과수
-
pyymm
integer
연도와 월별 정보
- 2.2 검색결과 건(item)별 출력 정보
-
필드
값
설명
-
title
string
제목
-
authors
-
저자명들
여러 명의 저자를 child element인 author로 구분합니다. -
author
-
하위요소
order = 저자순서, url=식별된 저자의 url, name=저자명
-
publisher
-
하위요소
url = 발행기관 url, name = 발행기관명 -
publication
-
간행물명
콘텐츠 유형이 논문, 챕터, 항목일 경우에만 표시됩니다.
하위요소
url = 간행물 url, name = 간행물명 -
issue_yymm
string
발행년월
-
pages
string
페이지 시작페이지~끝페이지(총페이지수)로 구성되어 있습니다.
콘텐츠 유형이 논문일 경우에만 표시됩니다. -
free_yn
Y | N
무료, 유료 여부
-
price
string
가격
-
preview_yn
Y | N
미리보기 여부
-
preview
string
미리보기 링크
-
link_url
string
상세정보 링크
-
link_api
string
비즈니스 API 링크
- 3. 예제 URL
- 4. 에러 메시지
-
번호
에러 메시지
설명
-
E0001
Unregistered key
등록되지 않은 키입니다.
-
E0002
Key necessary
요청변수중 키가 누락되었습니다.
-
E0003
Invalid target
target이 누락되었거나 잘못 지정되었습니다. 알 수 없는 서비스입니다.
-
E0004
Invalid version
API 버전 오류
-
E0005
Incorrect itype and collection
자료유형과 출처구분은 하나만 쓸 수 있습니다.
-
E0006
Incorrect itype
자료유형을 잘못 지정하였습니다.
-
E0007
Incorrect collection
데이터베이스를 잘못 지정하였습니다.
-
E0008
Invalid year type
연도는 숫자로 지정해야 합니다.
-
E0009
Incorrect year value
시작연도와 종료연도 중 하나가 누락되었습니다.
-
E0010
Keyword necessary
검색어는 필수입니다. 전체, 저자명, 간행물명, 발행기관명중 최소한 하나는 입력되어야 합니다.
-
E0011
Incorrect query request
기타 잘못된 쿼리 요청
-
E0012
Invalid key
사용할 수 없는 키입니다.
-
E0013
Incorrect key and os
키와 OS가 등록 내용과 맞지 않습니다.
-
E0014
Unregistered IP Address
등록되지 않은 IP주소입니다.
-
E0015
Service call timeout
서비스 시간이 초과되었습니다.
-
E0016
No result
검색결과가 없습니다.
-
E0017
Query request over limit
쿼리 요청 제한을 초과하였습니다.
-
E0018
Undefined Error
정의되지 않은 오류가 발생하였습니다.
-
E0000
System error
시스템 에러