Netvision.ApiClient.Abstractions

Общая регистрация аутентифицированных HTTP API-клиентов NetVision.

{
  "ApiClient": {
    "ClientId": "service-client-id",
    "ClientSecret": "service-client-secret",
    "TokenUrl": "http://identity/connect/token",
    "BaseUrls": {
      "AnalyticsConfigurationService": "http://analytics-configuration-service"
    }
  }
}

Пакеты клиентов регистрируют типизированный клиент через AddApiClient, передавая каноническое имя целевого сервиса, например analytics-configuration-service. Это имя используется для именованного HttpClient и данных наблюдаемости; для поиска базового URL оно преобразуется в AnalyticsConfigurationService.

Предыдущие разделы конфигурации ApiClientConfiguration и <Service>ApiClient:BaseUrl читаются только при отсутствии нового раздела ApiClient. Оба варианта проверяются при регистрации сервиса.

ValidateServerCertificate по умолчанию равен true и в конфигурации не указывается. Добавляйте значение false только в средах разработки с недоверенным сертификатом сервера: для зарегистрированных API-клиентов будет добавлен разрешающий callback проверки сертификата.

Для внешних API, которые хранят параметры в собственной секции или используют другой механизм авторизации, можно подготовить конфигурацию самостоятельно:

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

services.AddApiClient<IClient, Client>(resolved, "external-service");

ConfigureNetvisionApiClientEndpoint(resolved.ToEndpoint()) настраивает только базовый адрес и проверку сертификата. Его следует применять для клиентов с собственной авторизацией, например для внешнего API с Basic login.