Описание: Проверить действительность 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 |