.NET SDK

Быстрый старт #

using DashaMail;

var dashamail = new DashaMailClient("YOUR_API_KEY");

var balance = await dashamail.Account.BalanceAsync();
Console.WriteLine(balance["balance"]);

var created = await dashamail.Lists.CreateAsync("Newsletter");
await dashamail.Lists.AddMemberAsync(created["list_id"], "subscriber@example.com",
    new Dictionary<string, object> { { "merge_1", "Иван" } });

await dashamail.Transactional.SendAsync(
    "subscriber@example.com",
    "sender@yourdomain.com",
    "<p>Спасибо за подписку!</p>",
    new Dictionary<string, object> { { "subject", "Добро пожаловать" } });

Ресурсы #

DashaMailClient — фасад с одним свойством на каждый раздел API, типы — в DashaMail.Resources. Методы Task-based (суффикс Async) и возвращают DashaMailResponse (оборачивает data как Dictionary<string, object> или List<object>, перебирается через foreach) либо бросают DashaMailApiException. Необязательные параметры — завершающий Dictionary<string, object>, поскольку у API слишком много полей, чтобы у каждого был свой типизированный аргумент.

Пагинация #

int start = 0;
while (true)
{
    var page = await dashamail.Lists.MembersAsync(listId,
        new Dictionary<string, object> { { "start", start }, { "limit", 100 } });
    foreach (var member in page) { /* ... */ }
    start += page.Limit ?? 0;
    if (!page.HasMore) break;
}

Ошибки #

Каждый неуспешный ответ бросает подкласс DashaMailApiException, выбранный по HTTP-статусу. У любого исключения есть ApiCode — тот же код, что в справочнике ошибок, HttpStatus и Details. Все исключения непроверяемые (RuntimeException), так что вызывающий код не обязан их объявлять.

Если ответ вообще не пришёл (обрыв сети, таймаут) — бросается DashaMailNetworkException, отдельно от ошибок самого API.

Изображения #

// Готовый файл на диске — без ручного base64:
var result = await dashamail.Images.OptimizeFileAsync("/path/to/banner.png");

// Сырые байты в ответ вместо base64 в JSON:
var binary = await dashamail.Images.OptimizeFileBinaryAsync("/path/to/banner.png");
binary.SaveTo("/path/to/banner-optimized.png");