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