Responses & Error Handling

// Complete HTTP/REST error handling pattern
using System.Net.Http;
using System.Net.Http.Json;

try
{
    var response = await httpClient.GetAsync("/BizEntity?PageSize=10");

    // Level 1: Check HTTP status code
    if (response.StatusCode == System.Net.HttpStatusCode.Unauthorized)
    {
        Console.WriteLine("Token expired - refreshing...");
        await RefreshTokenAsync();
        response = await httpClient.GetAsync("/BizEntity?PageSize=10");
    }
    else if (response.StatusCode == System.Net.HttpStatusCode.ServiceUnavailable)
    {
        Console.WriteLine("Service busy - retrying with backoff...");
        await Task.Delay(1000); // 1 second
        response = await httpClient.GetAsync("/BizEntity?PageSize=10");
    }

    // Level 2: Parse response body
    var result = await response.Content.ReadFromJsonAsync<APIResponse>();

    // Check business logic success (even if HTTP 200)
    if (!result.Result)
    {
        Console.WriteLine($"Business error: {result.Message}");
        return;
    }

    // Success - process data
    Console.WriteLine($"Success! Retrieved {result.RecordCount} entities");
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"HTTP error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

// Complete SDK error handling pattern
using SevenG.API.SDK;
using System.Net;

try
{
    var filter = new BizEntityFilter { PageSize = 10 };
    var response = await client.BizEntity.GetAsync(filter);

    // Level 2: Check business logic success
    if (!response.Result)
    {
        Console.WriteLine($"Business error: {response.Message}");

        // Handle specific business errors
        if (response.Message.Contains("not found"))
        {
            Console.WriteLine("Entity doesn't exist");
        }
        else if (response.Message.Contains("already exists"))
        {
            Console.WriteLine("Duplicate record detected");
        }

        return;
    }

    // Success - deserialize and process
    var entities = JsonSerializer.Deserialize<List<BizEntityDTO>>(
        JsonSerializer.Serialize(response.Data)
    );

    Console.WriteLine($"Success! Retrieved {entities.Count} entities");
}
catch (HttpRequestException ex) when (ex.StatusCode == HttpStatusCode.Unauthorized)
{
    Console.WriteLine("Authentication failed - token expired");
    // SDK auto-refreshes, so this means refresh also failed
    await client.Auth.LoginAsync(username, password);
}
catch (HttpRequestException ex) when (ex.StatusCode == HttpStatusCode.ServiceUnavailable)
{
    Console.WriteLine("Service temporarily unavailable - retry with backoff");
    await Task.Delay(2000); // 2 seconds
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"HTTP error {ex.StatusCode}: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}