Unimatrix C# / .NET SDK

インストール

.NET向けUnimatrix SDKは NuGet から利用できます。

.NET CLIを使う場合:

dotnet add package UniSdk

Visual StudioのPackage Manager Consoleを使う場合:

Install-Package UniSdk

利用方法

クライアントの初期化

using UniSdk;

var client = new UniClient("your access key id", "your access key secret"); // Simple Mode の場合は第1引数のみ

環境変数の利用も可能です。

export UNIMTX_ACCESS_KEY_ID=your_access_key_id
export UNIMTX_ACCESS_KEY_SECRET=your_access_key_secret

SMSの送信

using System;
using UniSdk;

class Program
{
    static void Main(string[] args)
    {
        var client = new UniClient();

        try
        {
            var resp = client.Messages.Send(new {
                to = "+1206880xxxx",  // E.164形式
                text = "Your verification code is 2048."
            });
            Console.WriteLine(resp.Data);
        }
        catch (UniException ex)
        {
            Console.WriteLine(ex);
        }
    }
}

非同期で実行する例:

using System;
using System.Threading.Tasks;
using UniSdk;

class Program
{
    static async Task Main(string[] args)
    {
        var client = new UniClient();

        try
        {
            var resp = await client.Messages.SendAsync(new {
                // ...
            });
            Console.WriteLine(resp.Data);
        }
        catch (UniException ex)
        {
            Console.WriteLine(ex);
        }
    }
}

テンプレートを使用する例:

client.Messages.Send(new {
    to = "+1650253xxxx",
    signature = "Unimatrix",
    templateId = "pub_verif_en_basic2",
    templateData = new {
        code = "2048"
    }
});

認証コード（OTP）の送信

using System;
using UniSdk;

class Program
{
    static void Main(string[] args)
    {
        var client = new UniClient();
        var resp = client.Otp.Send(new {
            to = "+1206880xxxx"
        });
        Console.WriteLine(resp.Data);
    }
}

認証コード（OTP）の検証

using System;
using UniSdk;

class Program
{
    static void Main(string[] args)
    {
        var client = new UniClient();
        var resp = client.Otp.Verify(new {
            to = "+1206880xxxx",
            code = "123456" // ユーザーが入力した認証コード
        });
        Console.WriteLine(resp.Valid);
    }
}