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

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

Best practice — вызвать этот API перед созданием нового target image.

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

Action

Есть три API. Обычно, если требуется только image search by image, достаточно комплексной оценки recognizability.

POST /grade/detection
- Предоставляет только комплексный результат по recognizability
POST /grade/tracking
- Предоставляет только комплексный результат по trackability
POST /grade/detail
- Предоставляет подробную многомерную оценку алгоритма

Authentication

Требуется

Http Header

Content-Type=application/json

HTTP Header: Authorization (при использовании authentication API Key Token)

Параметры request

Field	Type	Required	Description
image	String(base64)	Yes	Base64 encoded string содержимого изображения. Поддерживаются изображения JPG и PNG. Максимальный размер изображения 2MB.

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

Поле	Описание
statusCode	Status code 0 означает корректную authentication. Подробнее см. Status codes
result	Сообщение об ошибке или grade
timestamp	Серверное время возврата response. Используется формат Unix timestamp, в миллисекундах
result.grade	[-1, 0, 1, 2, 3, 4], где 0 и 1 означают легкое recognition. 4 — наиболее сложно распознать. -1 означает, что изображение не соответствует требованиям.

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