Управление устройством
----------------------

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

Установка времени
=================

Установить текущее время на устройство (устройство распознавания не имеет RTC). **sec** и **usec** обычно получаются с помощью **gettimeofday**.

**URL интерфейса:** http://172.22.0.6/api/set_time

**Метод запроса:** POST

**Content-Type:** json

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

.. code::

    {
        "sec": 1742894010,
        "usec": 615948
    }

+----------+-----------+---------+-----------+--------------------------+
|Параметр  |Пример     |Тип      |Обязательно|Описание                  |
|          |значения   |         |?          |                          |
+==========+===========+=========+===========+==========================+
|sec       |1742894010 |Number   |Да         |Возвращается              |
|          |           |         |           |**gettimeofday**          |
+----------+-----------+---------+-----------+--------------------------+
|usec      |615948     |Number   |Да         |Возвращается              |
|          |           |         |           |**gettimeofday**          |
+----------+-----------+---------+-----------+--------------------------+

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

.. code::

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

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

Получение информации об устройстве
====================================

Получить информацию об устройстве: **app**, **download**, **engine**, **firmware**, **masterIP**, **mastersyncPort**, **masterSN**, **sn**, **sync**, **sync_limit**, **syncMode**, **learnMode**, **soldOutLimit**, **upload**, **board**.

**URL интерфейса:** http://172.22.0.6/api/get_device_info

**Метод запроса:** GET

**Content-Type:** none

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

.. code::

    {
        "code": 0,
        "data": {
            "app": "9.0.6",
            "board": "1109",
            "download": true,
            "engine": "9.6",
            "firmware": "9.9.5.7",
            "item_count": 3,
            "learnMode": 1,
            "masterIP": "",
            "mastersyncPort": 7443,
            "masterSN": "",
            "max_result_num": 5,
            "predict_speed": "fast",
            "sn": "10110102",
            "soldOutLimit": 0,
            "sync": "2025-06-19_16:55:52",
            "sync_limit": 3,
            "sync_mode": "master",
            "upload": true
        }
    }

+------------------+-------------------+---------+-------------------------------+
|Параметр          |Пример значения    |Тип      |Описание                       |
|                  |                   |         |                               |
+==================+===================+=========+===============================+
|code              |0                  |Number   |Код результата: 0 - успех      |
+------------------+-------------------+---------+-------------------------------+
|data.app          |9.0.6              |String   |Версия приложения, наиболее    |
|                  |                   |         |часто обновляемые модули       |
+------------------+-------------------+---------+-------------------------------+
|data.engine       |9.6                |String   |Версия движка, движок          |
|                  |                   |         |распознавания                  |
+------------------+-------------------+---------+-------------------------------+
|data.firmware     |9.9.5.7            |String   |Версия прошивки, системные     |
|                  |                   |         |функции                        |
+------------------+-------------------+---------+-------------------------------+
|data.item_count   |3                  |Number   |Количество товаров для         |
|                  |                   |         |распознавания                  |
+------------------+-------------------+---------+-------------------------------+
|data.learnMode    |1                  |Number   |Статус режима обучения         |
+------------------+-------------------+---------+-------------------------------+
|data.masterIP     |""                 |String   |IP мастер-устройства           |
+------------------+-------------------+---------+-------------------------------+
|data.mastersyncPort|7443              |Number   |Порт мастер-устройства для     |
|                  |                   |         |синхронизации                  |
+------------------+-------------------+---------+-------------------------------+
|data.masterSN     |""                 |String   |SN мастер-устройства           |
+------------------+-------------------+---------+-------------------------------+
|data.soldOutLimit |3                  |Number   |Время автоматического удаления |
|                  |                   |         |товара, в днях                 |
+------------------+-------------------+---------+-------------------------------+
|data.max_result_num|5                 |Number   |Максимальное количество        |
|                  |                   |         |результатов **get_result**     |
+------------------+-------------------+---------+-------------------------------+
|data.predict_speed|fast               |String   |Скорость **get_result**        |
+------------------+-------------------+---------+-------------------------------+
|data.sn           |10110102           |String   |Уникальный SN модуля           |
+------------------+-------------------+---------+-------------------------------+
|data.sync         |9.6.0.0            |String   |Версия пакета синхронизации    |
+------------------+-------------------+---------+-------------------------------+
|date.sync_limit   |3                  |Number   |Количество измененных шаблонов |
+------------------+-------------------+---------+-------------------------------+
|data.sync_mode    |normal             |String   |Текущий режим синхронизации    |
+------------------+-------------------+---------+-------------------------------+
|data.download     |true               |Boolean  |Получать результаты обучения   |
|                  |                   |         |других                         |
+------------------+-------------------+---------+-------------------------------+
|date.upload       |true               |Boolean  |Делиться собственными          |
|                  |                   |         |результатами обучения          |
+------------------+-------------------+---------+-------------------------------+
|date.board        |1109               |String   |Тип платы                      |
+------------------+-------------------+---------+-------------------------------+

Установка дополнительной информации
=====================================

Установить пользовательские данные (Store_Name, Store_Dep, Store_Id и т.д.).

**URL интерфейса:** http://172.22.0.6/api/set_extra_info

**Метод запроса:** POST

**Content-Type:** json

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

.. code::

    {
        "store_name": "test",
        "store_id": "001",
        "store_dep": "test"
    }

+----------+-----------+---------+-----------+---------------------+
|Параметр  |Пример     |Тип      |Обязательно|Описание             |
|          |значения   |         |?          |                     |
+==========+===========+=========+===========+=====================+
|store_name|-          |String   |Нет        |Пользовательские     |
|          |           |         |           |данные               |
+----------+-----------+---------+-----------+---------------------+
|store_id  |-          |String   |Нет        |Пользовательские     |
|          |           |         |           |данные               |
+----------+-----------+---------+-----------+---------------------+
|store_dep |-          |String   |Нет        |Пользовательские     |
|          |           |         |           |данные               |
+----------+-----------+---------+-----------+---------------------+

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

.. code::

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

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

Получение дополнительной информации
====================================

Получить пользовательские данные (Store_Name, Store_Dep, Store_Id и т.д.).

**URL интерфейса:** http://172.22.0.6/api/get_extra_info

**Метод запроса:** GET

**Content-Type:** none

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

.. code::

    {
        "code": 0,
        "data": {
            "store_name": "test",
            "store_id": "001",
            "store_dep": "test"
        }
    }

+----------+-----------+---------+----------------------------------+
|Параметр  |Пример     |Тип      |Описание                          |
|          |значения   |         |                                  |
+==========+===========+=========+==================================+
|code      |0          |Number   |Код результата: 0 - успех         |
+----------+-----------+---------+----------------------------------+
|data      |-          |Json     |Установлено **set_extra_info**    |
+----------+-----------+---------+----------------------------------+

Сброс устройства до заводских настроек
======================================

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

**URL интерфейса:** http://172.22.0.6/api/reset_device

**Метод запроса:** POST

**Content-Type:** none

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

.. code::

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

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

Перезагрузка модуля распознавания
=================================

Перезагрузить модуль распознавания.

**URL интерфейса:** http://172.22.0.6/api/reboot

**Метод запроса:** POST

**Content-Type:** none

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

.. code::

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

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