한국 DOI 센터

home
문의하기
상단으로 이동

지식재산권 이용통계

개요

  • DOI 등록 유형 중 지식재산권 종류별 이용 건수를 조회하는 API.
  • 이용 통계는 파라미터 groupBy 값에 따라 연도별(Y), 월별(M), 일별(D)로 합산된 결과가 제공됨.
  • 이용 통계는 전월을 기준으로 산출되어 제공됨.
  • 이용 통계는 요청 파라미터에 포함된 ID와 Prefix로 등록된 DOI에 대해서만 조회 가능.

요청

  • URL: https://www.doi.or.kr/manage/api/v1/statistics/usage/property.do
  • HTTP Method: GET
  • 파라미터
이름 의미 설명 필수 기본값
key API 키 등록기관별로 발급된 API로, DOI등록관리시스템에 로그인 한 후 자신의 정보 페이지에서 조회 -
prefix 조회대상 DOI접두사 없으면 요청한 등록기관에게 할당된 Prefix에 한해 조회 -
type 권리구분 없으면 모든 권리구분 조회 현재 미적용
startDate 조회범위 시작일자 yyyyMMdd 형식

이전달 첫일

20170901
endDate 조회범위 끝일자 yyyyMMdd 형식

이전달 말일

20170930
groupBy 집계 단위 기간

• Y: 연도별 건수

• M: 연월별 건수

• D: 일별 건수

 M
일별 조회시 최대 92일간까지 가능

응답

  • Content-Type: text/xml;charset=UTF-8
  • 형식
태그 필수 반복 의미 설명
response
@version
 버전 “1”로 고정
summary
result

• SUCCESS: 성공

• FAIL: 오류
message
 메시지
query
 사용된 파라미터 값 요청된 값과 다를 수도 있다
prefix
 조회대상 DOI접두사
type
 권리구분
startDate
 조회범위 시작일자
endDate
 조회범위 끝일자
groupBy
 집계 단위 기간
records
 조회 결과 통계 목록
record
 최대 n번 조회 결과 통계
type
 권리구분
year
 연도
month
 월 연별 집계일 때는 값이 없다
day
 일 연별, 월별 집계일 때는 값이 없다
count
 이용 건수

오류코드

No 오류
1 파라미터 값이 제출되지 않았습니다.
2 사용자 인증에 실패하였습니다.
3 접근이 허가된 IP 주소가 아닙니다.
4 일단위 이용 현황은 최대 92일(3개월)이내만 가능합니다.
서비스