특징
- KISTI에서 구축된 연구기관 정보를 검색할 수 있는 OpenAPI입니다.
연구자
국내 연구기관 중 식별된 연구기관의 논문, 보고서, 특허 목록을 제공하는 OpenAPI
입력 파라미터 (* 는 필수 항목입니다.)
| 구분 | 설명 | 비고 | |
|---|---|---|---|
| * client_id | 클라이언트 ID | 발급받은 신청기관 식별용 클라이언트 ID(64자리 영문숫자) | |
| * token | ACCESS_TOKEN 값 | 신청기관 인증을 위해 발급받은 토큰(토근발급 및 활용방법 메뉴 참조) | |
| version | 1.0 | API Gateway 현재 버전 : 1.0 | |
| * action | API action 구분 | 기본값 : search | |
| * target | 콘텐츠(연구기관) 약어 | 기본값 : ORGAN | |
| * searchQuery | {"검색필드항목":"검색어"} | 아래 검색필드(searchField) 참조 예시) {“BI”:”코로나”} , URI 인코딩 필수 |
|
| sortField | 정렬 필드 | 정렬(sortField) 항목 참조 | |
| sortBy | 정렬 방법 | asc : 오름차순, desc : 내림차순 | |
| curPage | 현재 페이지번호 | 기본 값 : 1, curPage x rowCount는 10,000건 미만으로 한정 | |
| rowCount | 디스플레이 건수 | 기본 값 : 10, 최대값 : 100 | |
| session_id | 사용자 세션 ID | 클라이언트 사용자 구분 및 이용 형태 분석용으로 사용 | |
검색필드(searchField)
| 코드값 | 코드 설명 | ||
|---|---|---|---|
| BI | 전체 | ||
| TI | 연구기관명 | ||
| CN | 식별기관 일련번호 | ||
정렬(sortField)
| 코드값 | 코드 설명 | 정렬옵션(sortBy) | |
|---|---|---|---|
| newdoc | 최신자료순 | desc(내림차순) | |
| kor_orgnm | 기관명(국문) | desc(내림차순),asc(오름차순) 중 택1 | |
| eng_orgnm | 기관명(영문) | desc(내림차순),asc(오름차순) 중 택1 | |
| NULL | 정확도 | desc(내림차순) | |
< desc : 내림차순, asc : 오름차순 >
출력 결과
| 항목코드 | 항목설명 | ||
|---|---|---|---|
| CN | Contents Number (콘텐츠 식별값, Primary key로 활용됨) | ||
| OrganKor | 기관명(국문) | ||
| OrganEng | 기관명(영문) | ||
| Keyword | 키워드 | ||
| Rno | 원시제어번호 | ||
| ArticleCnt | 기관 논문 건수 | ||
| PatentCnt | 기관 특허 건수 | ||
| ReportCnt | 기관 보고서 건수 | ||
요청 URL(Request URL) 형식
- https://apigateway.kisti.re.kr/openapicall.do?client_id=[클라이언트 ID]&token=[ACCESS_TOKEN 값]&version=1.0&action=[API action 구분]&target=[콘텐츠 약어]&searchQuery=[{"검색필드항목":"검색어"}]&sortField=[정렬 필드]&curPage=[현재 페이지번호]&rowCount=[디스플레이 건수]&session_id=[사용자 세션 ID]
요청 URL(Request URL) 샘플
- https://apigateway.kisti.re.kr/openapicall.do?client_id=2300BD0DD3DCC8D01E59AAEBD2BDFD398147E59B40C1F32E548FDC51D7C99708&token=C1DEC7D42FCB325978D374F44807CB5D4F5D8161587AF3B3C76A1860B2F3BA02&version=1.0&action=search&target=ORGAN&searchQuery={"BI":"korea"}&sortField=kor_orgnm&curPage=1&rowCount=10&session_id=5gHgMl0lfen84Ib7nT4P9jl5H1EiEfeG5l9jB07w47rB1dwN9aYvaLV1kUNaIUsI
샘플 출력 결과
출력 XML 샘플 보기