Mbs SDK

Mbs SDK is a client library that enables easier integration with the Mbs web interface. SDK provides entities (messages sent to and recevived from the server) as well as websocket connection handling.

Installation

SDK can be obtained from nuget repository.

Usage

Initialize the SDK

Create MbsSdkConfig configuration object with the values provided by Sportradar:

MbsSdkConfig config = new MbsSdkConfig(
        wsServer, authServer, authClientId, authClientSecret, authAudience, operatorId);

Use the config to create MbsSdk instance and establish a connection to the server:

MbsSdk mbsSdk = new MbsSdk(config);
mbsSdk.Connect();

The SDK is threadsafe and a single instance can be used for the entire application lifespan.

Use the SDK

Operations that are supported by the SDK are grouped into protocols, eg: all ticket operations are available under ITicketProtocol.

The SDK instances exposes all the protocols through getter property, eg:

mbsSdk.TicketProtocol;

Each operation (method) exposed by the protocol is generally of a request/response form. Each method accepts its Request object (eg: TicketRequest, CancelRequest, ...) and returns matching Response object (eg: TicketResponse, CancelResponse, ...) and each method can be used in async or blocking context:

// create appropriate request
OperationRequest request = new OperationRequest();
// async
OperationResponse response = await mbsSdk.Protocol.executeOperationAsync(request);
// blocking
OperationResponse response = mbsSdk.Protocol.executeOperationAsync(request).Result;

Example of ticket place operation:

TicketRequest request = new TicketRequest
{
    Context = new TicketContext
    {
        LimitId = 1234567890,
        ... // omitted for brevity
    },
    TicketId = "ticketId-1234567890",
    ... // omitted for brevity
};
TicketResponse response = await sdk.TicketProtocol.SendTicketAsync(request);

Close the SDK

When MbsSdk instance is not needed anymore, invoke Dispose() to release the resources: