Xtensos.SDK 3.0.2

Xtensos SDK

Overview

The Xtensos SDK is a tool designed for .NET developers to simplify the use of Xtensos's services. It currently supports Xtensos's Connect and Translate REST APIs. This SDK allows for rapid integration of both human and machine translation capabilities into your application.

Features

1. Built-in and configurable retry policies.
2. Individual service classes that mimic single API calls.
3. Manager class for the Connect service, further easing the process of working with the API.

REST APIs

1. Connect API: https://connect.xtensos.com/docs
2. Translate API: https://translate-api.xtensos.com/docs

Development environment

1. .NET Standard 2.0
2. Visual Studio / Rider

SDK Usage Examples

Human Translation

ConnectService

using Xtensos.SDK.Client.Connect;
using Xtensos.SDK.Core.Connect.Settings;

var configuration = new Configuration(....)
var connectService = new ConnectService(configuration);

ConnectManager

using Xtensos.SDK.Client.Connect;
using Xtensos.SDK.Core.Connect.Settings;

var configuration = new Configuration(....)
var connectManager = new ConnectManager(configuration);

Machine Translation

using Xtensos.SDK.Client.Translate;
using Xtensos.SDK.Core.Translate.Settings;

var configuration = new Configuration(....)
var translationService = new TranslationService(configuration);

Retry policy configuration

All the services come with a preconfigured retry policy, set with a retry count of 5 and a retry duration of 500ms. If you wish to modify these settings, you can specify your preferences in the configuration.

using Xtensos.SDK.Client.Translate;
using Xtensos.SDK.Core.Translate.Settings;

var configuration = new Configuration(
    clientId,
    clientSecret,
    retryCount: 5,
    retryDuration: 500
);

var translationService = new TranslationService(configuration);

Custom Http Client

Xtensos.SDK allows to override HTTP client. To do so, you need to implement the IRestClientFactory interface, which as a result returns the RestSharp client.

public interface IRestClientFactory
{
    IRestClient Build(RestClientOptions restClientOptions);
}

Then you need to pass your implementation to the configuration.

using Xtensos.SDK.Client.Translate;
using Xtensos.SDK.Core.Translate.Settings;

var configuration = new Configuration(
    clientId,
    clientSecret,
    clientFactory: new MyCustomRestClientFactory()
);

var translationService = new TranslationService(configuration);