오픈API 이용안내

오픈API v0.1

기계학습 데이터 공유·활용 서비스 오픈 API는 공개된 기계학습 데이터셋 정보를 이용자들이 보다 손쉽게 활용 할 수 있도록, 제공하는 개방형 API 서비스 입니다. 제공되는 기계학습 데이터셋 정보는 기관 또는 개인이 자유롭게 활용하여, 다양한 컨텐츠를 생산하는데 도움을 주는데 목적을 두고 있으며, 누구나 손쉽게 데이터를 활용할 수 있도록 웹서비스 방식(JSON/REST)으로 서비스를 제공합니다.

지나치게 잦은 API의 호출로 서버에 과도한 부하가 발생하여 다른 사용자의 이용에 지장을 줄 경우 이용에 제한이 발생할 수 있으니 서비스의 이용 시 주의를 부탁 드립니다.

GET/openapi/data 데이터셋 검색 API (데이터셋 검색결과를 제공합니다.)
Parameters
Name Description
key
발급된 인증키
page 페이지 번호
size 페이지당 출력건수
q 검색 키워드
GET/openapi/data/{dataset_id} 데이터셋 조회 API (데이터셋 상세정보를 제공합니다.)
Parameters
Name Description
key
발급된 인증키
GET/openapi/file/{file_id} 데이터 파일 다운로드 API (데이터 파일을 다운로드합니다.)
Parameters
Name Description
key
발급된 인증키
POST/openapi/road_object_detection 도로영상 객체인식 API (주어진 이미지에서 도로영상 관련 13종 객체를 인식하여 결과를 JSON형태로 반환함)
Parameters
Name Description
body object
{
    key: '발급된 인증키',                                             
    img_filename: '이미지파일명',
    img_base64: '이미지파일을 Base64코드로 변환한 값'
}

Parameter content type : application/json

Responses
Code Description
200
{
    class: '인식객체정보',                                             
    left: '사각형 왼쪽 위 x 좌표',
    top: '사각현 왼쪽 위 y 좌표',
    width: '인식객체 너비',
    height: '인식객체 높이'
}

Response content type : application/json

Example
Code Description
python3.x

사용방법 : python client.py image.jpg

import base64
import json
import requests
import sys
if __name__ == "__main__":
    $URL = ‘https://aida.etri.re.kr/openapi/road_object_detection’
    img_filename = sys.argv[1]
    with open(img_filename, 'rb') as img_file:
        my_string = base64.b64encode(img_file.read())
    sending_msg = {"key": "발급된 인증키", "img_filename":img_filename, "img_base64": my_string.decode('utf-8')}
    result = requests.post($URL, data = json.dumps(sending_msg))