Zindua.Sdk 1.0.1

Zindua.Sdk

Official .NET 8 SDK for Zindua — send transactional email and WhatsApp OTP from ASP.NET Core.

Server-side only. Never put ZINDUA_API_KEY in Blazor WebAssembly, SPA, or mobile apps.

Install

dotnet add package Zindua.Sdk

Quick start (ASP.NET Core)

using Zindua;
using Zindua.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddZindua(builder.Configuration);

var app = builder.Build();

app.MapPost("/auth/otp", async (IZinduaClient zindua, OtpRequest req) =>
{
    var result = await zindua.SendAsync(new ZinduaSendOptions
    {
        To = req.Email,
        Template = "otp-login",
        Channel = "email",
        Lang = "en",
        Variables = new Dictionary<string, string>
        {
            ["code"] = req.Code,
            ["appName"] = "MyApp",
        },
    });
    return Results.Ok(new { result.LogId });
});

app.Run();

record OtpRequest(string Email, string Code);

appsettings.json:

{
  "Zindua": {
    "ApiKey": "znd_test_xxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Or environment variable:

export ZINDUA_API_KEY=znd_test_xxxxxxxxxxxxxxxxxxxxxxxx

WhatsApp

await zindua.SendAsync(new ZinduaSendOptions
{
    To = "+243812345678",
    Channel = "whatsapp",
    Template = "otp-login",
    Variables = new Dictionary<string, string> { ["code"] = "482910" },
});

WhatsApp anti-ban robot (required)

Zindua’s anti-ban robot enforces a ≥ 3 second gap between WhatsApp sends to protect your linked number from bans. Burst / simultaneous OTP looks like spam.

• Server returns RATE_LIMIT_EXCEEDED / wait messages if you ignore the gap.
• SDK defaults AutoPaceWhatsapp = true: waits on this client and writes a warning to stderr.
• Your app should still use a queue or resend countdown in production.

Guide: WhatsApp OTP anti-ban pacing

builder.Services.Configure<ZinduaClientOptions>(o =>
{
    o.ApiKey = builder.Configuration["Zindua:ApiKey"]!;
    // o.AutoPaceWhatsapp = false; // only if you already queue OTP yourself
});

Other methods

var project = await zindua.GetProjectAsync();
var templates = await zindua.GetTemplatesAsync();
var log = await zindua.GetLogAsync(result.LogId);

Without DI

using var client = new ZinduaClient(new ZinduaClientOptions
{
    ApiKey = Environment.GetEnvironmentVariable("ZINDUA_API_KEY")!,
});

await client.SendAsync(new ZinduaSendOptions
{
    To = "user@example.com",
    Template = "otp-login",
});

Docs

• Marketing: https://zindua.run/dotnet
• Dashboard: https://zindua.run/dashboard/developper
• Example: examples/login-otp-aspnet in the Zindua monorepo

License

MIT