Nieuwe SDK's voor .NET, Rust, Elixir en Symfony

Bestaat je stack uit .NET, Rust, Elixir of Symfony? Dan kun je Lettermint nu met een officiële SDK aan je applicatie koppelen. Na de installatie verstuur je transactional e-mails en broadcast e-mails met een paar regels code.

Wellicht heb je de community packages voor .NET, Elixir en Symfony eerder voorbij zien komen. Die kun je blijven gebruiken. De officiële SDK's onderhouden we zelf. Komt er een nieuwe functie bij in Lettermint, dan voegen we deze ook toe aan de nieuwe SDK's.

E-mail versturen met .NET en C#

De .NET SDK installeer je via NuGet. Je hebt .NET 8 of nieuwer nodig. Kies daar voor Lettermint, niet te verwarren met de community SDK LettermintDotNet van ExciteOrg (opent in een nieuw venster).

Zo verstuur je je eerste e-mail:

          using Lettermint;

using var email = LettermintClient.Email("lm_project_token");

var response = await email
    .From("sender@acme.com")
    .To("recipient@acme.com")
    .Subject("Hello from Lettermint")
    .Html("<p>Hello World!</p>")
    .SendAsync();

        

In de .NET-handleiding lees je hoe je bijlagen toevoegt en de Team API gebruikt.

De Rust SDK is nu officieel

Franz Geffke (opent in een nieuw venster) bouwde de eerste versie van de Rust SDK. Wij hebben het onderhoud van hem overgenomen en er versie 1.0 van gemaakt. Die werkt nu op dezelfde manier als onze andere SDK's. Op crates.io vind je hem nog steeds onder de naam lettermint. De SDK werkt vanaf Rust 1.98. Je hebt ook een async runtime nodig, bijvoorbeeld Tokio.

In versie 1.0 ziet een e-mail er zo uit:

          use lettermint::Lettermint;

#[tokio::main]
async fn main() -> lettermint::Result<()> {
    let email = Lettermint::email("lm_project_token")?;

    email
        .email()
        .from("sender@acme.com")
        .to("recipient@acme.com")
        .subject("Hello from Lettermint")
        .html("<p>Hello World!</p>")
        .send()
        .await?;

    Ok(())
}

        

Gebruik je de Rust SDK al? Zolang lettermint = "0.3" in je Cargo.toml staat, verandert er niets. Wil je naar 1.0, lees dan eerst de migratiegids (opent in een nieuw venster). Alle opties vind je in de Rust-handleiding.

Transactional e-mails vanuit Elixir en Phoenix

De Elixir SDK staat op Hex en werkt vanaf Elixir 1.15. Je kunt hem in elk Mix-project gebruiken, dus ook in je Phoenix app. Een e-mail bouw je stap voor stap op:

          alias Lettermint.EmailBuilder, as: Email

client = Lettermint.email("lm_project_token")

client
|> Email.new()
|> Email.from("sender@acme.com")
|> Email.to(["recipient@acme.com"])
|> Email.subject("Hello from Lettermint")
|> Email.html("<p>Hello World!</p>")
|> Email.send()

        

Verstuur je mail via Swoosh? Dan kun je daar de Lettermint adapter (opent in een nieuw venster) voor houden. De SDK komt niet in de plaats van die adapter. Je hebt hem nodig als je ook de Team API wilt aanroepen of webhooks wilt verifiëren. Meer voorbeelden vind je in de Elixir-handleiding.

Lettermint koppelen aan Symfony Mailer

Voor Symfony Mailer installeer je lettermint/symfony-mailer via Composer. Je hebt PHP 8.2 nodig en Symfony Mailer 6.4, 7.4 of 8. Er bestond al een community integratie van somehow digital (opent in een nieuw venster). Die kun je ook blijven gebruiken.

Na de installatie registreer je de integratie één keer in config/services.yaml. Daarna zet je je project API token in de DSN:

      MAILER_DSN=lettermint+api://lm_project_token@default

    

Verder verstuur je e-mail zoals je gewend bent, via MailerInterface. Je bestaande code hoeft niet te veranderen. Zet je e-mails in de wachtrij met Symfony Messenger? Ook die gaan via Lettermint. Hoe je de integratie registreert, lees je in de Symfony-handleiding.

Alle officiële SDK's op een rij

De SDK's voor .NET, Rust en Elixir doen meer dan e-mail versturen. Je beheert er ook domeinen en projecten mee via de Team API, en je controleert er de handtekening van webhooks mee.

Met deze vier erbij hebben we officiële SDK's en integraties voor Node.js, Nuxt, PHP, Laravel, Symfony, Python, Go, Java, .NET, Elixir en Rust. Alle e-mail die je ermee verstuurt, verwerken we in de EU. Je vindt ze allemaal op onze integratiepagina.