Simple, cross-platform Mandrill api wrapper for .NET Core and .NET 4.6+
https://mandrillapp.com/api/docs/
Install-Package Mandrill.netdotnet build src/Mandrill.net
# if on mac/linux, you cannot build against the .net461 target:
# dotnet build src/Mandrill.net -f netstandard2.0You must set the user environment variable MANDRILL_API_KEY in order to run these tests. Go to https://mandrillapp.com/ to obtain an api key.
In order for the email from address to match your allowed sending domains, you can set MANDRILL_SENDING_DOMAIN to match your account.
# include MANDRILL_API_KEY and MANDRILL_SENDING_DOMAIN in your env. For example:
# MANDRILL_API_KEY=xxxxxxxxx MANDRILL_SENDING_DOMAIN=acme.com dotnet test tests
dotnet test testsvar api = new MandrillApi("YOUR_API_KEY_GOES_HERE");
var message = new MandrillMessage("from@example.com", "to@example.com",
"hello mandrill!", "...how are you?");
var result = await api.Messages.SendAsync(message);var api = new MandrillApi("YOUR_API_KEY_GOES_HERE");
var message = new MandrillMessage();
message.FromEmail = "no-reply@acme.com";
message.AddTo("recipient@example.com");
message.ReplyTo = "customerservice@acme.com";
//supports merge var content as string
message.AddGlobalMergeVars("invoice_date", DateTime.Now.ToShortDateString());
//or as objects (handlebar templates only)
message.AddRcptMergeVars("recipient@example.com", "invoice_details", new[]
{
new Dictionary<string, object>
{
{"sku", "apples"},
{"qty", 4},
{"price", "0.40"}
},
new Dictionary<string, object>
{
{"sku", "oranges"},
{"qty", 6},
{"price", "0.30"}
}
});
var result = await api.Messages.SendTemplateAsync(message, "customer-invoice");It is recommended that you do not create an instance of the MandrillApi for every request, to effectively pool connections to mandrill, and prevent socket exhaustion in your app. For example, an ASP.NET Core service registration that registers the API Interfaces as singletons:
var api = new MandrillApi("YOUR_API_KEY_GOES_HERE");
services.AddSingleton<IMandrillMessagesApi>(api.Messages);[HttpPost]
public IHttpActionResult MyWebApiControllerMethod(FormDataCollection value)
{
//optional: validate your webhook signature
// see https://mandrill.zendesk.com/hc/en-us/articles/205583257-How-to-Authenticate-Webhook-Requests
if(!ValidateRequest(value))
{
return Forbidden();
}
var events = MandrillMessageEvent.ParseMandrillEvents(value.Get("mandrill_events"));
foreach (var messageEvent in events)
{
// do something with the event
}
return Ok();
}
private bool ValidateRequest(FormDataCollection value)
{
IEnumerable<string> headers;
if (!Request.Headers.TryGetValues("X-Mandrill-Signature", out headers))
{
return false;
}
var signature = headers.Single();
var key = "MANDRILL_WEBHOOK_KEY_HERE";
return WebHookSignatureHelper.VerifyWebHookSignature(signature, key, Request.RequestUri, value.ReadAsNameValueCollection());
}See this issue to track progress of api implementation