연구데이터 검색 API

이 문서는 연구데이터 검색 API 서비스를 소개합니다.

개요

연구데이터 검색 API는 연구데이터 통합 검색결과를 API로 실행할 수 있게 하는 RESTful API입니다.

요청 URL

	https//dataon.kisti.re.kr/rest/api/search/dataset/

프로토콜

HTTPS

HTTP 메서드

GET/POST

요청 파라미터

파라미터(영문)	타입	필수항목	설명	예
key	CHAR	Y	승인된 발급키	DF7B7BE61ACF98D21EE71EAA21AB173
query	CHAR	Y	검색하기 위한 키워드	데이터
from	CHAR	N	페이지시작위치	0
size	CHAR	N	페이지사이즈	10

요청 예

API 사용 신청 등록된 서버 ip로만 API 접속이 허용됩니다. key는 발급받은 인증키를 사용하셔야 합니다.

• key는 발급받은 인증키를 사용하셔야 합니다.

https://dataon.kisti.re.kr/rest/api/search/dataset?key=91EF0AA92005F44182A6DD1F0A404CFA&query=covid%20virus&from=1000&size=1

응답 파라미터

파라미터(영문)	속성	반복	설명	예
svc_id			서비스 ID	473373a5bfef2c56632ea0be f204e955
ctlg_type			자료유형 코드	01:collection 02:dataset 03:file 04:image_nrms 05:software 06:workflow 07:model 08:image
dataset_type			국내외구분코드	01:국내 02:국외
ctlg_type_pc			자료유형	collection dataset file image_nrms software workflow model image
dataset_type_pc			국내외구분	국내,해외
dataset_pub_dt_pc			등록년도	2017년,..
dataset_access_type_pc			접근권한	공개 비공개 엠바고
file_yn_pc			파일접근방법	랜딩페이지이동, 직접다운로드
dataset_cc_license_pc			라이센스유형	CC-BY,..
dataset_main_lang_pc			작성언어	English,...
dataset_sub_lang_pc			작성부언어	none,English,...
cltfm_pc			데이터 제공처	국가R&D보고서등록관리시스템
dataset_title_kor			제목_한글	금속소재 고온 인장물성
dataset_title_etc_main			제목_다국어(주언어)	고등균류 DB
dataset_title_etc_sub			제목_다국어(부언어)	Korean Mushroom DB
dataset_expl_kor			내용_한글	1.한국의 버섯의 종류
dataset_expl_etc_main			내용_다국어(주언어)	1.한국의 버섯의 종류
dataset_expl_etc_sub			내용_다국어(부언어)	1.Types of mushrooms in Korea
dataset_kywd_kor			키워드_한글	버섯
dataset_kywd_etc_main			키워드_다국어(주언어)	버섯
dataset_kywd_etc_sub			키워드_다국어(부언어)	mushroom
cltfm_kor			수집처_한글	국가R&D보고서등록관리시스템
cltfm_etc			수집처_다국어	National R&D Reports Management System
dataset_data_loc			데이터수집지역	{type:point,coordinates:[0,0]}
dataset_lndgpg			데이터제공처링크	http://mushroom.ndsl.kr
dataset_lndgpg_img			이미지 데이터 URL	https://nrms.kisti.re.kr/ bitextimages/ TRKO201700007162/ TRKO20170000716 2_205_image_1.png
dataset_lndgpg_thum			데이터셋 썸네일 URL	https://do2020.kisti.re.kr/ canvas/rest/app/software/ 46/thumbnail
dataset_doi			DOI	10.8888/EPOPS2018111412Q
dataset_etc_attr			기타정보	json
dataset_regist_dt			시스템 등록일자	2020-09-25 00:50:40
dataset_mod_dt			시스템 갱신일자	0001-01-01 00:00:00
dataset_mnsb_pc			주제분류	생물과학
file_frmt_pc			파일유형	png
repo_pc			데이터 리포지터리	국가R&D보고서등록관리시스템
pjt_prfrm_org_pc			과제수행기관	한국과학기술정보연구원
ministry_pc			부처	과학기술정보통신부
dataset_creator_kor			생성자_한글	홍길동
dataset_creator_etc_main			생성자_다국어(주언어)	홍길동
dataset_creator_etc_sub			생성자_다국어(부언어)	Hong Gil Dong
pjt_prfrm_org_kor			과제수행기관_한글	한국과학기술정보연구원
pjt_prfrm_org_etc			과제수행기관_다국어	KISTI
ministry_kor			부처_한글	과학기술정보통신부
ministry_etc			부처_다국어	Ministry of Science and ICT
repo_kor			리포지터리_한글	한국과학기술정보연구원
repo_etc			리포지터리_다국어	Korea Institute of Science and Technology Information
pjt_nm_kor			과제명_한글	국가연구데이터 플랫폼 구축 및 운영
pjt_nm_etc			과제명_다국어	Construction and Operation of National Research data platform
pjt_mngr_kor			과제책임자_한글	홍길동
pjt_mngr_etc			과제책임자_다국어	Hong Gil Dong
pjt_prtpnt_kor			과제참여자_한글	홍길동
pjt_prtpnt_etc			과제참여자_다국어	Hong Gil Dong
dataset_cntrbtr_kor			기여자_한글	홍길동
dataset_cntrbtr_etc			기여자_다국어	Hong Gil Dong
dataset_pblshr			발행기관	한국과학기술정보연구원
dataset_pric			담당자	홍길동
rrno			국가연구자번호
ntisno			NTIS과제번호

응답 예

{
	"response": {
		"elapsed time": "30 ms",
		"status": "200",
		"message": "OK",
		"total count": 4961,
		"type": "json",
		"key": "91EF0AA92005F44182A6DD1F0A404CFA",
		"query": "covid virus",
		"from": 1000,
		"size": 2
	},
	"records": [{
			"svc_id": "a89c4b976180ecffb74924cc337e9a2c",
			"ctlg_type": "02",
			"dataset_type": "02",
			"ctlg_type_pc": "dataset",
			"dataset_type_pc": "해외",
			"dataset_pub_dt_pc": "2018",
			"dataset_access_type_pc": "공개",
			"file_yn_pc": "랜딩페이지이동",
			"dataset_cc_license_pc": "none",
			"dataset_main_lang_pc": "English",
			"dataset_sub_lang_pc": "none",
			"cltfm_pc": "OpenAIRE",
			"dataset_title_kor": "",
			"dataset_title_etc_main": "Virus alignments found in human cancer - aidinfo table",
			"dataset_title_etc_sub": "",
			"dataset_expl_kor": "",
			"dataset_expl_etc_main": "<p>The file contains one row for every analysis_id (column name &#39;aid&#39;) analyzed for the paper. An analysis_id is a unique TCGA BAM file.</p>",
			"dataset_expl_etc_sub": "",
			"dataset_kywd_kor": "",
			"dataset_kywd_etc_main": "",
			"dataset_kywd_etc_sub": "",
			"cltfm_kor": "",
			"cltfm_etc": "OpenAIRE",
			"dataset_data_loc": "{type:point,coordinates:[0,0]}",
			"dataset_lndgpg": "https://doi.org/10.5281/zenodo.3668362",
			"dataset_lndgpg_img": "",
			"dataset_lndgpg_thum": "",
			"dataset_doi": "10.5281/zenodo.3668362",
			"dataset_etc_attr": "",
			"dataset_regist_dt": "2020-11-24 01:43:13",
			"dataset_mod_dt": "2020-11-25 19:33:48",
			"dataset_mnsb_pc": ["none"],
			"file_frmt_pc": ["none"],
			"repo_pc": ["Zenodo"],
			"pjt_prfrm_org_pc": ["none"],
			"ministry_pc": ["none"],
			"dataset_creator_kor": [""],
			"dataset_creator_etc_main": [""],
			"dataset_creator_etc_sub": [""],
			"pjt_prfrm_org_kor": [""],
			"pjt_prfrm_org_etc": [""],
			"ministry_kor": [""],
			"ministry_etc": [""],
			"repo_kor": [""],
			"repo_etc": ["Zenodo"],
			"pjt_nm_kor": [""],
			"pjt_nm_etc": [""],
			"pjt_mngr_kor": [""],
			"pjt_mngr_etc": [""],
			"dataset_cntrbtr_kor": [""],
			"dataset_cntrbtr_etc": [""],
			"dataset_pblshr": [""],
			"dataset_pric": [""],
			"rrno": [""],
			"ntisno": [""]
		}
	}