Keep Exception Messages

using Flurl.Http;
using Feenics.Keep.WebApi.Wrapper;

public async Task<PersonInfo?> AddPersonSafelyAsync(InstanceInfo instance, PersonInfo newPerson)
{
    try
    {
        // Wrapper returns the created person or throws on error
        var person = await client.AddPersonAsync(instance, newPerson);
        
        // Important: Some wrapper methods may return null instead of throwing
        if (person == null)
        {
            Console.WriteLine("Person creation returned null - check permissions or instance state");
            return null;
        }
        
        return person;
    }
    catch (FailedOutcomeException ex) when (ex.HttpStatus == System.Net.HttpStatusCode.Conflict)
    {
        // Duplicate name or similar conflict
        // ResponseString contains the full KeepException details
        Console.WriteLine($"Conflict creating person: {ex.ResponseString}");
        return null;
    }
    catch (FailedOutcomeException ex) when (ex.HttpStatus == System.Net.HttpStatusCode.Forbidden)
    {
        // Permission denied - ResponseString provides specific permission error details
        Console.WriteLine($"Permission denied: {ex.ResponseString}");
        return null;
    }
    catch (FailedOutcomeException ex) when (ex.HttpStatus == System.Net.HttpStatusCode.BadRequest)
    {
        // Validation error - ResponseString includes which validation rule failed
        Console.WriteLine($"Validation failed: {ex.ResponseString}");
        return null;
    }
    catch (FailedOutcomeException ex)
    {
        // Other API errors (500, etc.) - always log ResponseString for troubleshooting
        Console.WriteLine($"API error: HTTP {ex.HttpStatus} - {ex.ResponseString}");
        return null;
    }
    catch (FlurlHttpException ex)
    {
        // Network-level errors (connection timeout, DNS failure, etc.)
        Console.WriteLine($"Network error: {ex.Message}");
        return null;
    }
    catch (Exception ex)
    {
        // Unexpected errors - log and rethrow
        Console.WriteLine($"Unexpected error: {ex.Message}");
        throw;
    }
}

// Direct HTTP call - returns KeepException details in response body
using System.Net.Http;
using System.Text.Json;

var response = await httpClient.PostAsJsonAsync($"{apiUrl}/api/f/{instanceKey}/Person", newPerson);

if (!response.IsSuccessStatusCode)
{
    var errorJson = await response.Content.ReadAsStringAsync();
    var error = JsonDocument.Parse(errorJson);
    
    // Access error details from JSON response
    var exceptionCode = error.RootElement.GetProperty("Error").GetString();
    var message = error.RootElement.GetProperty("Message").GetString();
    
    switch (exceptionCode)
    {
        case "CannotInsertDuplicateName":
            Console.WriteLine($"A person with this name already exists: {message}");
            break;
        case "PermissionsError":
            Console.WriteLine($"Permission denied: {message}");
            break;
        default:
            Console.WriteLine($"Error: {exceptionCode} - {message}");
            break;
    }
}

import requests

response = requests.post(f"{api_url}/api/f/{instance_key}/Person", 
                         json=person_data, headers=headers)

if response.status_code != 200:
    error = response.json()
    error_code = error.get('Error', 'Unknown')
    
    if error_code == 'CannotInsertDuplicateName':
        print(f"Duplicate name: {person_data['CommonName']}")
    elif error_code == 'PermissionsError':
        print("Permission denied")
    else:
        print(f"Error: {error_code} - {error.get('Message')}")