이미지 recognizability 난이도 평가 | POST /grade/detection

이미지 recognition 난이도를 0부터 4까지 순서대로 점수화합니다. 점수가 클수록 난이도가 높음을 의미합니다. -1은 손상된 이미지나 흰 종이 등 이미지가 requirement를 충족하지 않아 발생한 recognition error를 의미합니다.

Best practice는 새 target image를 만들기 전에 이 API를 호출하는 것입니다.

Grade	설명
0 또는 1	Target을 쉽게 감지할 수 있음
2	보통
3 또는 4	Target을 감지하기 어려움

Action

세 가지 API로 나뉩니다. 일반적으로 image search by image만 하는 경우 recognizability에 대한 종합 rating만 필요합니다.

POST /grade/detection
- recognizability에 대한 종합 결과만 제공
POST /grade/tracking
- trackability에 대한 종합 결과만 제공
POST /grade/detail
- 다차원 상세 알고리즘 rating 제공

Authentication

필요

Http Header

Content-Type=application/json

HTTP Header: Authorization (API Key Token authentication 사용 시)

request 매개변수

Field	Type	Required	Description
image	String(base64)	Yes	이미지 content의 base64 encoded string. JPG 및 PNG 형식 이미지를 지원합니다. 이미지 최대 2MB.

반환 필드

필드	설명
statusCode	Status code 0은 authentication이 올바름을 의미합니다. 자세한 내용은 Status code 참조
result	Error message 또는 grade
timestamp	response 반환 시 서버 측 시간. Unix timestamp 형식을 사용하며 단위는 밀리초
result.grade	[-1, 0, 1, 2, 3, 4], 여기서 0과 1은 recognition이 쉬움을 의미합니다. 4가 가장 recognition하기 어렵습니다. -1은 이미지가 requirement를 충족하지 않음을 의미합니다.

Error codes

Status codes and error codes 참조

request 예시

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

return 예시

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }

Table of Contents