Complete .NET Example

dotnet new console -o device-park-quickstart
cd device-park-quickstart
dotnet add package Testinium.DevicePark

export DEVICEPARK_CLIENT_ID=your-client-id
export DEVICEPARK_CLIENT_SECRET=your-client-secret

using Testinium.DevicePark;
using Testinium.DevicePark.Errors;
using Testinium.DevicePark.Models;

using var client = DeviceParkApiClient.Builder()
    .Url("https://devicepark.testinium.io")
    .Credentials(Credentials.FromEnvironment())
    .Timeout(60)
    .Build();

string? allocationId = null;
string? sessionId = null;

try
{
    var devices = await client.Devices.ListAsync(new ListDevicesRequest.Builder()
        .Page(0)
        .Size(20)
        .AddFilter(DeviceFilter.STATE, "HEALTHY", SearchOperation.EQUAL)
        .Build());

    var serial = devices.Data.FirstOrDefault(candidate => candidate.Serial is not null)?.Serial;
    if (serial is null)
    {
        throw new InvalidOperationException("No visible device has a serial number");
    }

    var allocation = await client.Allocations.CreateAsync(new DeviceAllocationRequest.Builder()
        .Serial(serial)
        .Priority(3)
        .Build());

    allocationId = allocation.AllocationId
        ?? throw new InvalidOperationException("Allocation response does not contain allocationId");

    if (allocation.DeviceSerial is null)
    {
        throw new InvalidOperationException(
            $"Allocation {allocationId} is queued at position {allocation.Position?.ToString() ?? "unknown"}");
    }

    var session = await client.Sessions.StartAsync(new DeviceStartSessionRequest.Builder()
        .AllocationId(allocationId)
        .UserId(42)
        .UserEmail("[email protected]")
        .CompanyId(7)
        .CompanyName("Example Company")
        .VideoRecording(true)
        .Build());

    sessionId = session.SessionId
        ?? throw new InvalidOperationException("Session response does not contain sessionId");

    Console.WriteLine($"allocationId={allocationId} sessionId={sessionId} deviceSerial={session.DeviceSerial}");

    // Run Appium automation here while the session is active.
}
catch (DeviceParkHttpException error)
{
    Console.Error.WriteLine($"Device Park request failed: {error.Status} {error.ErrorCode} {error.ErrorMessage}");
    throw;
}
finally
{
    if (sessionId is not null)
    {
        try
        {
            await client.Sessions.StopAsync(sessionId);
        }
        catch (DeviceParkException error)
        {
            Console.Error.WriteLine($"Could not stop session {sessionId}: {error.Message}");
        }
    }

    if (allocationId is not null)
    {
        try
        {
            await client.Allocations.DeleteAsync(allocationId);
        }
        catch (DeviceParkException error)
        {
            Console.Error.WriteLine($"Could not release allocation {allocationId}: {error.Message}");
        }
    }
}

dotnet run