Reo.Core.BaseClient 10.0.162

Reo.Core.BaseClient.Client

Описание пакета

Пакет Reo.Core.BaseClient.Client предоставляет обобщенный HTTP-клиент для выполнения аутентифицированных запросов к внешним API. Он упрощает работу с OAuth-токенами, обработку параметров запроса и интеграцию с сервисами аутентификации. Используется в приложениях, где требуется взаимодействовать с внешними REST-сервисами, требующими токенов доступа и передачи параметров в URL.

Основные функции:

• Поддержка OAuth-токенов через IUserInfoService.
• Обработка параметров запроса в виде словаря.
• Асинхронные HTTP-запросы с сериализацией ответа в объекты.
• Интеграция с ASP.NET Core через DI-контейнер.

Основные компоненты

• IReoHttpClient<TResponse> – интерфейс для выполнения HTTP-запросов, возвращающий объект типа TResponse.
• ReoHttpClient<TResponse> – реализация интерфейса, использующая Flurl.Http для выполнения запросов и инжектирования токена доступа.
• ReoClientConfigureExtensions – методы расширения для регистрации клиента в DI-контейнере ASP.NET Core.

Требования

• .NET версия: .NET 8.0 (так как указано в csproj).
• Зависимости:
  • Flurl.Http (для работы с HTTP-запросами).
  • Reo.Core.IdentityModel (для получения токенов доступа через IUserInfoService).

Установка

# NuGet Package Manager
Install-Package Reo.Core.BaseClient.Client

# .NET CLI
dotnet add package Reo.Core.BaseClient.Client

Настройка

Регистрация в ASP.NET Core

Добавьте клиент в DI-контейнер через метод расширения:

services.AddReoHttpClient<MyResponse>();

Конфигурационные параметры

• Токен доступа: Получается через IUserInfoService (инжектирован в ReoHttpClient).
• Параметры запроса: Передаются как IReadOnlyDictionary<string, string>.

Использование

Пример 1: Получение данных из API

public class MyResponse
{
 public string Data { get; set; }
}

// В сервисе или контроллере
private readonly IReoHttpClient<MyResponse> _client;

public MyService(IReoHttpClient<MyResponse> client)
{
 _client = client;
}

public async Task GetDataAsync()
{
 var url = new Url("https://api.example.com/data");
 var parameters = new Dictionary<string, string>
 {
 { "page", "1" },
 { "limit", "10" }
 };

 var response = await _client.GetAsync(url, parameters);
 Console.WriteLine(response.Data);
}

Пример 2: Использование токена доступа

// Если токен не предоставлен явно, он будет автоматически получен через IUserInfoService
var response = await _client.GetAsync(url, parameters, userToken: "explicit_token");

Лицензия

Данный пакет распространяется под лицензией MIT.