SDK C# / .NET de Unimatrix

Installation

La méthode recommandée pour installer le SDK Unimatrix pour .NET est d'utiliser le gestionnaire de paquets nuget, disponible sur NuGet.

Si vous développez avec la CLI .NET, exécutez la commande suivante pour ajouter UniSdk comme dépendance à votre projet :

dotnet add package UniSdk

Si vous utilisez l'IDE Visual Studio, exécutez la commande suivante dans la Console du Gestionnaire de Paquets :

Install-Package UniSdk

Utilisation

L'exemple suivant montre comment utiliser le SDK .NET Unimatrix pour interagir avec les services Unimatrix.

Initialiser un client

using UniSdk;

var client = new UniClient("votre access key id", "votre access key secret"); // si vous utilisez le mode d'authentification simple, passez juste le premier paramètre

ou vous pouvez configurer vos identifiants par des variables d'environnement :

export UNIMTX_ACCESS_KEY_ID=votre_access_key_id
export UNIMTX_ACCESS_KEY_SECRET=votre_access_key_secret

Envoyer SMS

Envoyer un message texte à un seul destinataire.

using System;
using UniSdk;

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

        try
        {
            var resp = client.Messages.Send(new {
                to = "+1206880xxxx",  // au format E.164
                text = "Votre code de vérification est 2048."
            });
            Console.WriteLine(resp.Data);
        }
        catch (UniException ex)
        {
            Console.WriteLine(ex);
        }
    }
}

ou utilisez la méthode asynchrone :

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

Envoyer un message en utilisant un modèle avec des variables.

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

Envoyer OTP

Envoyer un code à usage unique (OTP) à un destinataire. L'exemple suivant enverra un code de vérification généré automatiquement à l'utilisateur.

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

Vérifier OTP

Vérifier le code à usage unique (OTP) fourni par un utilisateur. L'exemple suivant vérifiera si le code de vérification fourni par l'utilisateur est correct.

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" // le code fourni par l'utilisateur
        });
        Console.WriteLine(resp.Valid);
    }
}