# 연구데이터 검색 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 | | sortCon | CHAR | N |

정렬 기준 | | |
(title: 제목 / date : 발행일 | | | | | | / score: 정확도)

| title | | | | | sortArr | CHAR | N |

정렬 순서 | | |
(asc: 오름차순 / desc: 내림차순)

| asc | | | | ### 요청 예 {% hint style="danger" %} **key는 발급받은 인증키를 사용하셔야 합니다.** {% endhint %} * **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 | | | 데이터제공처링크 | | | dataset\_lndgpg\_img | | | 이미지 데이터 URL |

bitextimages/

TRKO201700007162/

TRKO20170000716

2\_205\_image\_1.png

| | dataset\_lndgpg\_thum | | | 데이터셋 썸네일 URL |

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": "

The file contains one row for every analysis_id (column name 'aid') analyzed for the paper. An analysis_id is a unique TCGA BAM file.

", "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": [""] } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://dataon.gitbook.io/dataon-user-guide/sharing/openapi/search_api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.