Installation

dotnet add package OpenEmail

using OpenEmail; var client = new OpenEmailClient(); var sent = await client.Emails.SendAsync(new Body{    ["from"] = "Acme Billing <[email protected]>",    ["to"] = "[email protected]",    ["subject"] = "Your September invoice",    ["html"] = "<p>Invoice attached.</p>",}); Console.WriteLine($"{sent["id"]} {sent["status"]}");

new OpenEmailClient() lit la clé dans OPENEMAIL_API_KEY : le code ne contient donc aucun identifiant. Passez new OpenEmailOptions { ApiKey = ... } quand votre configuration se trouve ailleurs. Une clé absente ou mal formée lève ArgumentException à la construction du client, avant tout envoi.

Un corps de requête est un Body, ou n'importe quel IReadOnlyDictionary<string, object?>, dont les clés gardent les noms de l'API, si bien que scheduledAt s'écrit ici comme dans la référence de l'API. Une réponse est un JsonObject de System.Text.Json.Nodes, qui se lit avec sent["id"].

Sur .NET 10, un seul fichier s'exécute sans projet. La ligne #:package récupère le package, et dotnet run send.cs envoie le message.

#:package OpenEmail@* using OpenEmail; var client = new OpenEmailClient(); var sent = await client.Emails.SendAsync(new Body{    ["from"] = "[email protected]",    ["to"] = "[email protected]",    ["subject"] = "Sent from one file",    ["text"] = "No project was needed.",}); Console.WriteLine(sent["id"]);

Le package cible net8.0 et netstandard2.0. Sur .NET 8 et versions ultérieures, il n'a aucune dépendance, et il peut être découpé et compilé à l'avance sans risque. Sur .NET Standard 2.0, il apporte System.Text.Json et Microsoft.Bcl.AsyncInterfaces. Un client peut être utilisé sans risque par de nombreux threads à la fois : construisez-en un au démarrage du programme et partagez-le.