Распознавание¶

REST API v2 предоставляет улучшенные возможности для настройки и управления процессом распознавания товаров, включая гибкие настройки скорости, режимов обучения и обратной связи.

Установка скорости распознавания¶

Установить скорость распознавания (чем быстрее, тем ниже точность распознавания). Скорость может быть normal или fast. fast аналогична предыдущей версии. normal медленнее предыдущей, но дает лучший результат распознавания. По умолчанию fast.

URL интерфейса: http://172.22.0.6/api/set_predict_speed
Метод запроса: POST
Content-Type: application/json

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

{
    "speed": "normal"
}

Параметр	Пример значения	Тип	Обязательно ?	Описание
speed	normal	String	Да	Скорость распознавания

Пример успешного ответа

{
    "code": 0,
    "data": null
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data	—	Null	—

Получение результата распознавания¶

Получить результат распознавания на основе текущего изображения камеры.

URL интерфейса: http://172.22.0.6/api/get_result
Метод запроса: GET
Content-Type: none

Пример успешного ответа

{
    "code": 0,
    "data": {
        "items": [
            {
                "id": "002",
                "score": 0.29
            },
            {
                "id": "003",
                "score": 0.28
            },
            {
                "id": "001",
                "score": 0.25
            },
            {
                "id": "004",
                "score": 0.18
            }
        ],
        "sid": "19700101082633041672962"
    }
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data.items	—	Array	Список PLU и оценок
data.sid	19700101082633041672962	String	ID этого распознавания

Установка максимального количества результатов¶

Установить максимальное количество результатов за одно распознавание, от 1 до 5.

URL интерфейса: http://172.22.0.6/api/set_max_result
Метод запроса: POST
Content-Type: application/json

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

{
    "num": 3
}

Параметр	Пример значения	Тип	Обязательно ?	Описание
num	3	Number	Да	Максимальное количество результатов

Пример успешного ответа

{
    "code": 0,
    "data": null
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data	—	Null	—

Отзыв о результате распознавания¶

Передать результаты распознавания модулю распознавания для самообучения. Функция имеет 3 варианта, которые можно установить через set_learnmode:

disabled — не влияет на модуль распознавания
limited — только оптимизирует точность распознавания товара, не добавляя новые шаблоны
full — оптимизирует точность распознавания товара и добавляет новые шаблоны при необходимости
URL интерфейса: http://172.22.0.6/api/result_feedback
Метод запроса: POST
Content-Type: application/json

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

{
    "sid": "19700101082633041672962",
    "id": "001"
}

Параметр	Пример значения	Тип	Обязательно?	Описание
sid	19700101082633041672962	String	Да	ID распознавания, возвращенный get_result
id	001	String	Да	PLU товара, выбранный пользователем

Пример успешного ответа

{
    "code": 0,
    "data": null
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data	—	Null	—

Установка режима обучения¶

Установить режим обучения. Модуль распознавания имеет два способа улучшения производительности распознавания: add/delete_item_template и result_feedback. Эта опция может устанавливать их в различные режимы.

Режимы обучения:

0 — отключает и add/delete_item_template, и result_feedback;
1 — включает add/delete_item_template и устанавливает полную функциональность result_feedback;
2 — включает add/delete_item_template и устанавливает ограниченную функциональность result_feedback.
URL интерфейса: http://172.22.0.6/api/set_learnmode
Метод запроса: POST
Content-Type: application/json

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

{
    "mode": 1
}

Параметр	Пример значения	Тип	Обязательно ?	Описание
mode	1	Number	Да	Режим обучения, допустимы значения 0, 1, 2

Пример успешного ответа

{
    "code": 0,
    "data": null
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data	—	Null	—

Проверка настроек режима обучения¶

Проверить настройки режима обучения.

URL интерфейса: http://172.22.0.6/api/get_learnmode
Метод запроса: GET
Content-Type: none

Пример успешного ответа

{
    "code": 0,
    "data": {
        "mode": 1
    }
}

Параметр	Пример значения	Тип	Описание
code	0	Number	Код результата: 0 - успех
data.mode	1	Number	Режим обучения, допустимы значения 0, 1, 2. По умолчанию 1