오픈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종 객체를 인식하여 결과를 반환함)
Parameters
Name Description
body object
{
    key: '발급된 인증키',                                             
    img_filename: '이미지파일명',
    img_base64: '이미지파일을 Base64코드로 변환한 값'
}

Parameter content type : application/json

Responses
Code Description
200
[
    [
        '인식객체',
        '신뢰점수(confidence score)',
        [
            '사각형 중심 x 좌표',
            '사각형 중심 y 좌표',
            '인식객체 너비',
            '인식객체 높이'
        ]	    
    ],
    ...
]
[
    [
        'license_plate', 98.06, [1250, 828, 99, 49],
        'license_plate', 98.28, [613, 887, 133, 37],
        'bus', 99.82, [1062, 472, 472, 589],
        'car', 99.85, [559, 780, 439, 246],
    ],
    ...
]

 

 

 

인식객체 : car bus small_truck large_truck bike person cone speedbump pothole crack manhole face license_plate

Response content type : application/json

Example (python3.x)

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

import base64
import json
import requests
import sys
if __name__ == "__main__":
    $URL = ‘https://aida.kisti.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')}
    headers = {"Content-Type" : "application/json"}
    result = requests.post($URL, data = json.dumps(sending_msg), headers = headers)
    print(result.text)