Skip to content

About

TBC Open API Exchange Rates client SDK

Resources

Stars

10 stars

Watchers

3 watching

Forks

Repository files navigation

TBC.OpenAPI.SDK.ExchangeRates

​ NuGet version (TBC.OpenAPI.SDK.ExchangeRates) CI
​ Exchange Rates SDKs for TBC OpenAPI ​

Exchange Rate SDK

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

Prerequisites

​ In order to use the SDK it is mandatory to have apikey from TBC Bank's OpenAPI Devportal.
​ See more details 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: ​ ​

CoreApiAppExmaple ​

CoreConsoleAppExample ​

NetFrameworkExample

About

TBC Open API Exchange Rates client SDK

Resources

Stars

10 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages