Підтвердження права власності для Overvis

Запит підтверджує фізичний доступ до TR-100E під час підключення пристрою до Overvis за допомогою PIN-коду. Код відображається на пристрої не більше ніж 5 хвилин. Користувач може ввести цей код в Overvis або підтвердити підключення, вибравши Так на TR-100E.

Код є частиною поточного стану: він не зберігається у Flash/EEPROM і не повертається API стану.

POST /api/service/challenge/set/

Установлює, замінює або очищає запит на підтвердження.

Доступ: лише WireGuard, Bearer/неявна авторизація (user). Запит із локальної мережі повертає 403 ERROR_NO_ACCESS.

Установлення

{
  "code": "001274"
}

Поле code є обов’язковим і має містити від 1 до 12 цифр ASCII. Код передається як рядок, щоб зберегти початкові нулі. Новий запит замінює попередній і перезапускає 300-секундний таймер.

Відповідь 200:

{
  "status": "pending",
  "remainingSec": 300
}

Очищення

{
  "code": null
}

Відповідь 200:

{
  "status": "idle",
  "remainingSec": 0
}

Порожнє тіло або некоректний JSON повертає 400 ERROR_API_PARSING. Відсутнє поле, некоректний тип, порожній рядок, надто довгий код або код із символами, відмінними від цифр, повертає 400 ERROR_INVALID_ARGUMENT. Помилка перевірки не змінює поточний запит на підтвердження.

GET /api/service/challenge/status/

Отримує узгоджений знімок стану запиту на підтвердження.

Доступ: лише WireGuard, Bearer/неявна авторизація (user). Запит із локальної мережі повертає 403 ERROR_NO_ACCESS.

Відповідь 200:

{
  "status": "accepted",
  "remainingSec": 247
}

`status`	Значення
`idle`	Запит на підтвердження відсутній або очищений
`pending`	Код відображається, але фізичної відповіді ще не отримано
`accepted`	Користувач вибрав Так на TR-100E
`rejected`	Користувач вибрав Ні на TR-100E

Значення remainingSec зменшується від 300 до 1 у станах pending, accepted і rejected; у стані idle воно дорівнює 0. Відповідь користувача не перезапускає і не зупиняє таймер. Після закінчення початкових 300 секунд пристрій автоматично переводить запит на підтвердження у стан idle.

Після вибору Так TR-100E відображає екран очікування, доки Overvis не прочитає стан accepted і не надішле code: null. Очищення запиту на підтвердження завершує послідовність дій інтерфейсу користувача та повертає головний екран.

Якщо користувач підтверджує право власності, вводячи код в Overvis, хмарний сервіс порівнює його з початковим значенням і після успішної перевірки надсилає code: null, щоб прибрати запит з дисплея.