SDK Java de Unimatrix

Installation

La méthode recommandée pour installer le SDK Unimatrix pour Java est d'utiliser un outil de gestion de dépendances tel que Maven ou Gradle, disponible sur Maven Central.

Utilisateurs de Maven

Ajoutez cette dépendance à votre fichier pom.xml :

<dependency>
    <groupId>com.unimtx</groupId>
    <artifactId>uni-sdk</artifactId>
    <version>0.3.0</version>
</dependency>

Utilisateurs de Gradle

Ajoutez cette dépendance à votre fichier build.gradle :

implementation "com.unimtx:uni-sdk:0.3.0"

Utilisation

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

Initialisation

import com.unimtx.Uni;

public class Example {
    private static String ACCESS_KEY_ID = "votre access key id";
    private static String ACCESS_KEY_SECRET = "votre access key secret";

    public static void main(String[] args) {
        Uni.init(ACCESS_KEY_ID, ACCESS_KEY_SECRET); // si vous utilisez le mode d'authentification simple, passez juste le premier paramètre
    }
}

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

export UNIMTX_ACCESS_KEY_ID=votre_access_key_id
export UNIMTX_ACCESS_KEY_SECRET=votre_access_key_secret

Envoyer SMS

Envoyez un message texte à un seul destinataire.

import com.unimtx.Uni;
import com.unimtx.UniException;
import com.unimtx.UniResponse;
import com.unimtx.model.UniMessage;

class Example {
    public static void main(String[] args) {
        Uni.init();

        UniMessage message = UniMessage.build()
            .setTo("+1206880xxxx") // au format E.164
            .setText("Votre code de vérification est 2048.");

        try {
            UniResponse res = message.send();
            System.out.println(res.data);
        } catch (UniException e) {
            System.out.println("Erreur : " + e);
            System.out.println("RequestId : " + e.requestId);
        }
    }
}

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

Map<String, String> templateData = new HashMap<String, String>();
templateData.put("code", "2048");

UniMessage.build()
    .setTo("+1206880xxxx")
    .setSignature("Unimatrix")
    .setTemplateId("pub_otp_fr")
    .setTemplateData(templateData)
    .send();

Envoyer OTP

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

import com.unimtx.Uni;
import com.unimtx.UniResponse;
import com.unimtx.model.UniOtp;

class Example {
    public static void main(String[] args) {
        Uni.init();

        UniResponse res = UniOtp.build()
            .setTo("+1206880xxxx")
            .send();

        System.out.println(res.data);
    }
}

Vérifier OTP

Vérifiez 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.

import com.unimtx.Uni;
import com.unimtx.UniResponse;
import com.unimtx.model.UniOtp;

class Example {
    public static void main(String[] args) {
        Uni.init();

        UniResponse res = UniOtp.build()
            .setTo("+1206880xxxx")
            .setCode("123456") // le code fourni par l'utilisateur
            .verify();

        System.out.println(res.valid);
    }
}