Клиент FindFace от NTechLab

Клиент сохраняет сгенерированный HTTP-контракт API FindFace 2.3.3 и использует общие настройки endpoint-а из Netvision.ApiClient.Abstractions. Авторизация FindFace остаётся специализированной: Basic login, затем заголовок Authorization: Token.

Дополнительные JSON-конвертеры обрабатывают особенности Python API FindFace, который может возвращать null в полях, где это не предусмотрено спецификацией.

var configuration = ResolvedApiClientConfiguration.Create(
    clientId,
    clientSecret,
    tokenUrl,
    baseUrl,
    validateServerCertificate);

services.AddFindFaceClient(configuration);

Конфигурация может быть прочитана из любой секции приложения. Например, AIG использует NTechLabVendor:ClientId, ClientSecret, TokenUrl, BaseUrl и необязательный ValidateServerCertificate. Проверка сертификата включена по умолчанию.

Статусы калибровки proximity (Calibration_status)

Параметр calibration_status в swagger FindFace описан противоречиво: type: integer, а в enum стоят строки (NOT_CALIBRATED, AWAITING_SYNC и т.д.). Для Python это имена Django IntegerChoices, для NSwag — нет.

NSwag генерирует некомпилируемый enum:

public enum Calibration_status
{
    _AWAITING_PROXIMITY_MODEL = AWAITING_PROXIMITY_MODEL,
    // ...
}

Справа от = нет ни константы, ни числа. То же самое для Calibration_status2 (второй inline-enum у операции counters/count/).

Сгенерированный файл руками не править — следующая перегенерация всё сотрёт.

Обход:

1. В FindFaceApiClient.nswag в excludedTypeNames указаны Calibration_status и Calibration_status2. NSwag оставляет эти имена в сигнатурах, но сами enum не пишет.
2. Типы и числовые константы живут в Netvision.ApiClient.NTechLab.FindFace/Contract/CalibrationStatus.cs.
3. global using static CalibrationStatusConstants нужен на случай, если NSwag всё же сгенерирует _NAME = NAME: правая часть тогда берётся из констант.

Числа совпадают с ProximityCalibrationStatusEnum из ответа API:

В query уходит число, не строка (ConvertToString без [EnumMember]).

Что нельзя делать при перегенерации

• Убирать Calibration_status / Calibration_status2 из excludedTypeNames. Иначе NSwag снова напишет сломанный enum, и он столкнётся с нашим (CS0101 — дублирование типа).
• Удалять Contract/CalibrationStatus.cs. Тогда сигнатуры ссылаются на несуществующие типы (CS0246).
• Править FindFaceApiClient.generated.cs под эти enum. Правка не переживёт перегенерацию.
• После перегенерации обязательно собрать проект. Если NSwag перестал исключать типы — вернуть их в excludedTypeNames и не трогать generated.cs.

NullFindFaceApiClient реализует IFindFaceApiClient вручную. Если после перегенерации изменились сигнатуры CountersGet / CountersCount, stub нужно подправить отдельно.