.NET Framework

.NET Framework

Framework for integrating Exchange Rates



The repository contains the SDK for simplifying TBC Open API Exchange Rate API invocations on C# client application side.
​The library is written in the C# programming language and is compatible with .netstandard2.0 and .net6.0.​

Prerequisites

In order to use the SDK, it is mandatory to have apikey from TBC Bank's OpenAPI Developer portal.
​See more details on how to get ​apikey.


.Net Core Usage

​First step is to configure appsettings.json file with Exchange rate endpoint and TBC Portal apikey
​appsettings.json​

"ExchangeRates": {
"BaseUrl": "https://tbcbank-test.apigee.net/v1/exchange-rates/",
"ApiKey": "{apikey}"
  }

Then add Exchange rate client as an dependency injection
​Program.cs​

builder.Services.AddExchangeRatesClient(builder.Configuration.GetSection("ExchangeRates").Get<ExchangeRatesClientOptions>());

​After two steps above, setup is done and Exchange rate client can be injected in any container class:​Injection example:​

private readonly IExchangeRatesClient _exchangeRatesClient;
public TestController(IExchangeRatesClient exchangeRatesClient)
{
_exchangeRatesClient = exchangeRatesClient;
}

​Api invocation example:​

var result = await _exchangeRatesClient.GetOfficialRates(
new string[] { "EUR", "USD"},
cancellationToken
);

NetFramework Usage

​First step is to configure Web.config file with Exchange rate endpoint and TBC Portal apikey
​Web.config​

<add key="ExchangeRatesUrl" value="https://tbcbank-test.apigee.net/v1/exchange-rates/" />
<add key="ExchangeRatesKey" value="{apikey}" />

​In the Global.asax file at Application_Start() add following code
​Global.asax​

new OpenApiClientFactoryBuilder()
.AddExchangeRatesClient(new ExchangeRatesClientOptions
{
BaseUrl = ConfigurationManager.AppSettings["ExchangeRatesUrl"],
ApiKey = ConfigurationManager.AppSettings["ExchangeRatesKey"]
})
.Build();

​This code reads config parameters and then creates singleton OpenApiClientFactory, which is used to instantiate Exchange rate client.
​ExchangeRatesClient class instantiation and invocation example:​

var exchangeRatesClient = OpenApiClientFactory.Instance.GetExchangeRatesClient();
var result = await exchangeRatesClient.GetOfficialRates(new string[] { "EUR", "USD"});

​For more details see examples in repo:​​
​CoreApiAppExample
​CoreConsoleAppExample
​NetFrameworkExample


Did this page help you?