Оценка сложности распознавания изображения | POST /grade/detection

Оценка сложности распознавания изображения по шкале от 0 до 4, где большее значение означает большую сложность. -1 означает ошибку распознавания из-за несоответствия изображения требованиям (например, повреждение или пустой лист).

Лучшие практики: вызов этого интерфейса необходим перед созданием нового целевого изображения.

Grade	Описание
0 или 1	Цель легко обнаружить
2	Средняя сложность
3 или 4	Цель сложно обнаружить

Action

Предоставляется три интерфейса. Для поиска по изображению обычно требуется только комплексная оценка распознаваемости.

POST /grade/detection
- Возвращает только комплексный результат по распознаваемости.
POST /grade/tracking
- Возвращает только комплексный результат по отслеживаемости.
POST /grade/detail
- Возвращает детальную алгоритмическую оценку по нескольким параметрам.

Аутентификация

Требуется

Http-заголовки

Content-Type=application/json

HTTP-заголовок: Authorization (при использовании аутентификации через API Key Token)

Параметры запроса

Поле	Тип	Обязательно	Описание
image	String(base64)	Да	Строка в кодировке base64, содержащая изображение. Поддерживаются форматы JPG и PNG. Максимальный размер изображения — 2 МБ.

Возвращаемые поля

Поле	Описание
statusCode	Код состояния. 0 означает успешную аутентификацию. Подробнее см. Коды состояния
result	Сообщение об ошибке или оценка (grade)
timestamp	Время на сервере в момент ответа. В формате Unix timestamp (миллисекунды)
result.grade	[-1, 0, 1, 2, 3, 4]. 0 и 1 означают легкое распознавание. 4 — самое сложное. -1 означает несоответствие изображения требованиям.

Коды ошибок

См. Полный список кодов состояния и ошибок

Пример запроса

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

Пример ответа

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

Table of Contents