View Source

Описание: Проверить действительность QR-кода, ранее нанесённого на документ (обычно вызывается при сканировании QR-кода с бумажной копии документа — например, с планшета или телефона на стройплощадке, посторонним человеком без учётной записи на портале). Метод доступен без авторизации и выполняется под системной (служебной) учётной записью: права конкретного сканирующего не проверяются вовсе, ответ формируется исключительно на основе данных элемента.

Логика проверки настраивается через конфигурацию портала (поля "ревизия"/"статус" элемента и списки допустимых статусов "действителен"/"есть замечания"):

Если переданная ревизия не совпадает с текущей ревизией элемента — результат Invalid (документ устарел).
Если ревизия совпадает и статус элемента входит в список "действителен" — результат Valid.
Если ревизия совпадает, но статус входит в список "есть замечания" — результат Warning.
Если ревизия совпадает, но статус не входит ни в один из списков — результат Invalid.
Если поля ревизии/статуса не настроены в конфигурации — результат Undefined.

🌐 HTTP-информация

Метод: POST
URL: /stamp/api/qrcode/Check/{itemId} или /stamp/api/qrcode/Check/{itemId}/{revision}
Headers: авторизация не требуется — метод доступен анонимно

📥 Параметры запроса (URL Path)

Параметр	Тип	Описание
`itemId`	`Guid`	ID элемента, закодированный в QR-коде
`revision`	`string`	Необязательный. Ревизия элемента, закодированная в QR-коде на момент простановки

📤 Тело ответа (Response Body)

Поле	Тип	Описание
`id`	`Guid`	ID проверяемого элемента
`listId`	`Guid`	ID списка, к которому относится элемент
`itemName`	`string`	Имя элемента
`itemVersion`	`string`	Текущая ревизия элемента
`qrCodeCheckStatus`	`string`	Результат проверки: `Undefined`, `Valid`, `Invalid`, `Warning`