SDK de Unimatrix para C# / .NET

Instalación

La forma recomendada de instalar el SDK de Unimatrix para .NET es usar el gestor de paquetes nuget, disponible en NuGet.

Si estás construyendo con la CLI de .NET, ejecuta el siguiente comando para añadir UniSdk como una dependencia a tu proyecto:

dotnet add package UniSdk

Si usas el IDE de Visual Studio, ejecuta el siguiente comando en la Consola del Administrador de Paquetes:

Install-Package UniSdk

Uso

El siguiente ejemplo muestra cómo usar el SDK .NET de Unimatrix para interactuar con los servicios de Unimatrix.

Inicializa un cliente

using UniSdk;

var client = new UniClient("tu id de clave de acceso", "tu secreto de clave de acceso"); // si usas el modo de autenticación simple, solo pasa el primer parámetro

o puedes configurar tus credenciales por variables de entorno:

export UNIMTX_ACCESS_KEY_ID=tu_id_de_clave_de_acceso
export UNIMTX_ACCESS_KEY_SECRET=tu_secreto_de_clave_de_acceso

Enviar SMS

Envía un mensaje de texto a un único destinatario.

using System;
using UniSdk;

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

        try
        {
            var resp = client.Messages.Send(new {
                to = "+1206880xxxx",  // en formato E.164
                text = "Tu código de verificación es 2048."
            });
            Console.WriteLine(resp.Data);
        }
        catch (UniException ex)
        {
            Console.WriteLine(ex);
        }
    }
}

o usa el método así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);
        }
    }
}

Envía un mensaje usando una plantilla con variables.

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

Enviar OTP

Envía un código de paso único (OTP) a un destinatario. El siguiente ejemplo enviará un código de verificación generado automáticamente al usuario.

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

Verificar OTP

Verifica el código de paso único (OTP) que un usuario proporcionó. El siguiente ejemplo verificará si el código de verificación proporcionado por el usuario es correcto.

using System;
using UniSdk;

class Program
{
    static void Main(string[] args)
    {
        var client = a new UniClient();
        var resp = client.Otp.Verify(new {
            to = "+1206880xxxx",
            code = "123456" // el código proporcionado por el usuario
        });
        Console.WriteLine(resp.Valid);
    }
}