SDK C# / .NET da Unimatrix

Instalação

A maneira recomendada de instalar o SDK Unimatrix para .NET é usar o gerenciador de pacotes nuget, disponível em NuGet.

Se você estiver construindo com a CLI do .NET, execute o seguinte comando para adicionar UniSdk como uma dependência ao seu projeto:

dotnet add package UniSdk

Se você estiver usando o IDE do Visual Studio, execute o seguinte comando no Console do Gerenciador de Pacotes:

Install-Package UniSdk

Uso

O exemplo a seguir mostra como usar o SDK .NET da Unimatrix para interagir com os serviços da Unimatrix.

Inicialize um cliente

using UniSdk;

var client = new UniClient("seu id de chave de acesso", "seu segredo de chave de acesso"); // se usando modo de autenticação simples, apenas passe o primeiro parâmetro

ou você pode configurar suas credenciais por variáveis de ambiente:

export UNIMTX_ACCESS_KEY_ID=seu_id_de_chave_de_acesso
export UNIMTX_ACCESS_KEY_SECRET=seu_segredo_de_chave_de_acesso

Envie SMS

Envie uma mensagem de texto para um único destinatário.

using System;
using UniSdk;

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

        try
        {
            var resp = client.Messages.Send(new {
                to = "+1206880xxxx",  // no formato E.164
                text = "Seu código de verificação é 2048."
            });
            Console.WriteLine(resp.Data);
        }
        catch (UniException ex)
        {
            Console.WriteLine(ex);
        }
    }
}

ou use método assíncrono:

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);
        }
    }
}

Envie uma mensagem usando um template com variáveis.

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

Envie OTP

Envie um código de passagem único (OTP) a um destinatário. O exemplo a seguir enviará um código de verificação gerado automaticamente para o usuário.

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);
    }
}

Verifique OTP

Verifique o código de passagem único (OTP) fornecido por um usuário. O exemplo a seguir verificará se o código de verificação fornecido pelo usuário está correto.

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" // o código fornecido pelo usuário
        });
        Console.WriteLine(resp.Valid);
    }
}