Custodian.Infobip.Email 1.0.1

Custodian.Infobip.Email

A simple .NET client for the Infobip Email API, designed for dependency injection, HttpClientFactory, and resilience.

Quickstart

dotnet add package Custodian.Infobip.Email

1. Register Client

In your Program.cs or Startup.cs, register the client with the dependency injection container.

using Custodian.Infobip.Email.DependencyInjection;
using Custodian.Infobip.Email.Options;

builder.Services.AddInfobipEmailClient(o =>
{
    // The base URL for your Infobip account
    o.BaseUrl = new Uri("https://xxxxx.api.infobip.com"); 
    
    // Your Infobip API Key
    o.ApiKey = Environment.GetEnvironmentVariable("INFOBIP_API_KEY");
});

2. Send Email

Inject IInfobipEmailClient into your service or controller and use the SendAsync method.

using Custodian.Infobip.Email;
using Custodian.Infobip.Email.Models;

// Inject the client via constructor
public class MyService(IInfobipEmailClient emailClient)
{
    public async Task SendWelcomeEmailAsync(string userEmail, string userName)
    {
        var request = new ClientEmailMessageRequest
        {
            From = "donotreply@mycompany.com",
            Subject = "Welcome!",
            HtmlBody = "<b>Hello and welcome!</b><p>We are glad to have you.</p>",
            ToReceipient = 
            { 
                new EmailRecipient(userEmail, userName) 
            }
            // You can also add attachments here
        };

        try
        {
            var response = await emailClient.SendAsync(request);
            if (response.IsSuccess)
            {
                Console.WriteLine("Email sent successfully!");
            }
            else
            {
                // Handle cases where the API accepted the request but reported an error
                Console.WriteLine($"API failed to send email with status {response.StatusCode}.");
                Console.WriteLine($"Response: {response.ResponseBody}");
            }
        }
        catch (HttpRequestException ex)
        {
            // Handle network or non-success HTTP status code errors
            Console.WriteLine($"An HTTP error occurred: {ex.Message}");
        }
    }
}

Configuration

The AddInfobipEmailClient method configures the client using the following options:

• BaseUrl (required): The base URL for your Infobip account, e.g., https://{your-subdomain}.api.infobip.com.
• ApiKey (required): Your Infobip API Key. The client will use Authorization: App {ApiKey}.
• SendEndpointPath: The path for sending emails. Defaults to /email/4/messages.
• Timeout: The overall request timeout for the HttpClient. Defaults to 100 seconds.

Responses and Errors

• If the Infobip API returns a non-success status code (like 4xx or 5xx), the client will log the error and throw an HttpRequestException.
• On a successful HTTP response, the client returns an EmailMessageResponse object with the following properties:
  • IsSuccess (bool): Indicates if the HTTP request was successful.
  • StatusCode (int): The HTTP status code of the response.
  • ResponseBody (string): The raw JSON body of the response from the API.

Building the package

dotnet build -c Release
dotnet pack src/Custodian.Infobip.Email/Custodian.Infobip.Email.csproj -c Release -o ./nupkgs

License

MIT