External integrations overview for UpdaterAgent TMS

public interface IQuickManageBroker
{
    Task<Result<AccessTokenResponse>> GenerateTokenAsync(AccessTokenRequest request);
    Task<Result<List<DriverResponse>>> GetDriversAsync(string token, long companyId);
    Task<Result<TripResponse>> GetTripAsync(string token, string tripId);
    // ...
}

builder.Services.AddScoped<IQuickManageBroker, QuickManageBroker>();
builder.Services.AddScoped<IZippyBroker, ZippyBroker>();
builder.Services.AddScoped<ITelegramBotBroker, TelegramBotBroker>();

{
  "QuickManage": {
    "BaseUrl": "https://api.quickmanage.com",
    "ApiKey": "xxx",
    "HmacSecret": "xxx"
  },
  "Zippy": {
    "BaseUrl": "https://read.zippyeld.com/",
    "UnitsUri": "api/v2/units-by-usdot"
  }
}

public static class QuickManageErrors
{
    public static Error AuthenticationFailed =>
        new("QM.AuthenticationFailed", "Failed to authenticate with QuickManage");

    public static Error ApiCallFailed(string endpoint) =>
        new("QM.ApiCallFailed", $"API call to {endpoint} failed");
}

public class IntegrationProvider
{
    public long CompanyId { get; set; }
    public EIntegrationProviderKey Provider { get; set; }  // QuickManage, Zippy, Samsara, ...
    public string? ApiKey { get; set; }
    public string? ApiSecret { get; set; }
    public bool IsActive { get; set; }
    public Dictionary<string, string> Settings { get; set; }
}