Amilon.MyGate.API.Client 3.0.23

Amilon My Gate API Client

This client allows you to connect and use Amilon's My Gate API Client.

Usage

Single Tenant

You can configure the authentication parameters in the appsettings.json. Depending on your authentication type, you can configure

• ClientId
• ClientSecret

or/and optionally

• UserName
• Password

  "MyGate_API_Client": {
    "Environment": "STG",
    "ClientId": "your-client-id",
    "ClientSecret": "your-client-secret",
    "UserName": "your-username",
    "Password": "your-password",
    "Version": "2",
    "GrantType": "password",
    "Timeout": 60000
  }

You can configure the client in your app through Dependency Injection

• Startup.cs

public IConfiguration Configuration { get; }

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddMyGateClient(Configuration);
}

• Host Builder

var builder = Host.CreateApplicationBuilder(args);
builder.Services.AddMyGateClient(builder.Configuration);

Multi Tenant

You can configure the authentication parameters in the appsettings.json. Depending on your authentication type, you can configure

• ClientId
• ClientSecret

or/and optionally

• UserName
• Password

In this Multi Tenant mode, you can customize the appSettings to your own needs, it does not have to use a specific structure as the client will be initialized manually using the needed parameters in the AddMyGateClient method call.

"MyGate_API_Client": {
    "Environment": "STG",
    "Version": "2",
    "GrantType": "password",
    "Timeout": 60000
},
"MultiTenant": [
    {
        "ClientId": "your-client-id_1",
        "ClientSecret": "your-client-secret_1",
        "MyGateCredentials": {
            "UserName": "your-user-name_1",
            "Password": "your-password_1"
        }
    },
    {
        "ClientId": "your-client-id_2",
        "ClientSecret": "your-client-secret_2",
        "MyGateCredentials": {
            "UserName": "your-user-name_2",
            "Password": "your-password_2"
        }
    },
]   

You can configure the client in your app through Dependency Injection. MultiTenantHelper is a placeholder for a class you can make in order to get the specific credentials for a specific ClientId.

• Startup.cs

public IConfiguration Configuration { get; }

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public void ConfigureServices(IServiceCollection services)
{
    var GateConfig = Configuration.GetSection("MyGate_API_Client").Get<MyGateConfig>();

    services.AddMyGateClient(_ =>
    {
        var config = new GateConfig();
        var mygateCredentials = MultiTenantHelper.GetMyGateCredentials();
        config.ClientId = mygateCredentials.ClientId;
        config.ClientSecret = mygateCredentials.ClientSecret;
        config.GrantType = GateConfig.GrantType;
        config.Version = GateConfig.Version;
        config.Password = mygateCredentials.Password;
        config.UserName = mygateCredentials.UserName;
        return config;
    }, GateConfig.Environment, GateConfig.Timeout);
}

• Host Builder

var builder = Host.CreateApplicationBuilder(args);

    var GateConfig = Configuration.GetSection("MyGate_API_Client").Get<MyGateConfig>();

builder.Services.AddMyGateClient(_ =>
{
        var config = new GateConfig();
        var mygateCredentials = MultiTenantHelper.GetMyGateCredentials();
        config.ClientId = mygateCredentials.ClientId;
        config.ClientSecret = mygateCredentials.ClientSecret;
        config.GrantType = GateConfig.GrantType;
        config.Version = GateConfig.Version;
        config.Password = mygateCredentials.Password;
        config.UserName = mygateCredentials.UserName;
        return config;
    }, GateConfig.Environment, GateConfig.Timeout);