C# / .NET SDK

Installation

.NET CLI

dotnet add package Tracktile

Package Manager

Install-Package Tracktile

PackageReference

<PackageReference Include="Tracktile" Version="0.3.0" />

Quick Start

using Tracktile;

var client = new TracktileClient(jwt: "your-api-token");

var products = await client.Products.ListAsync();

Authentication

var client = new TracktileClient(jwt: "your-api-token");

Available Resources

Resource	Methods
client.Inventory	ReceiveAsync, MoveAsync, UpdateAsync, WasteAsync, AssignAsync, UnassignAsync, BundleAsync, MergeAsync, UnmergeAsync
client.Orders	ListAsync, CreateAsync, GetAsync, UpdateAsync, DeleteAsync, GetProductAttributesAsync
client.Products	ListAsync, CreateAsync, GetAsync, UpdateAsync, DeleteAsync, BatchUpdateAsync, FetchByIdsAsync
client.PurchaseOrders	ListAsync, CreateAsync, GetAsync, UpdateAsync, DeleteAsync
client.Shipments	ListAsync, CreateAsync, GetAsync, UpdateAsync, PatchAsync, DeleteAsync, GetItemsAsync
client.Suppliers	ListAsync, CreateAsync, GetAsync, UpdateAsync, DeleteAsync, GetDefaultOrderAsync
client.Transports	ListAsync, CreateAsync, GetAsync, UpdateAsync, DeleteAsync

Cancellation Support

All async methods accept a CancellationToken:

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));

try
{
    var products = await client.Products.ListAsync(cancellationToken: cts.Token);
}
catch (OperationCanceledException)
{
    // Handle timeout or cancellation
}

Error Handling

using Tracktile.Models.Errors;

try
{
    var product = await client.Products.GetAsync(id: "invalid");
}
catch (BadRequestException ex)
{
    // Handle 400 errors
}
catch (UnauthorizedException ex)
{
    // Handle 401 errors
}
catch (ForbiddenException ex)
{
    // Handle 403 errors
}
catch (NotFoundException ex)
{
    // Handle 404 errors
}
catch (ServerException ex)
{
    // Handle 500 errors
}

Retries

var client = new TracktileClient(
    jwt: "your-api-token",
    retryConfig: new RetryConfig
    {
        Strategy = RetryStrategy.Backoff,
        Backoff = new BackoffStrategy
        {
            InitialInterval = 1,
            MaxInterval = 50,
            Exponent = 1.1,
            MaxElapsedTime = 100
        },
        RetryConnectionErrors = false
    }
);

Dependency Injection

Register the client with ASP.NET Core’s DI container:

// In Program.cs or Startup.cs
builder.Services.AddSingleton<ITracktileClient>(sp =>
    new TracktileClient(jwt: builder.Configuration["Tracktile:ApiKey"])
);

// In your service or controller
public class ProductService
{
    private readonly ITracktileClient _client;

    public ProductService(ITracktileClient client)
    {
        _client = client;
    }

    public async Task<IEnumerable<Product>> GetProductsAsync()
    {
        return await _client.Products.ListAsync();
    }
}

Custom HTTP Client

var httpClient = new HttpClient
{
    Timeout = TimeSpan.FromSeconds(30)
};

var client = new TracktileClient(
    jwt: "your-api-token",
    httpClient: httpClient
);

Debug Logging

using Microsoft.Extensions.Logging;

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();
    builder.SetMinimumLevel(LogLevel.Debug);
});

var client = new TracktileClient(
    jwt: "your-api-token",
    logger: loggerFactory.CreateLogger<TracktileClient>()
);

Runtime Support

Runtime	Version
.NET	6.0+
.NET	8.0+ (recommended)

The SDK is fully async and follows .NET conventions for naming, error handling, and cancellation.