SDK de Unimatrix para Java

Instalación

La forma recomendada de instalar el SDK de Unimatrix para Java es con una herramienta de gestión de dependencias como Maven o Gradle, que está disponible en Maven Central.

Usuarios de Maven

Añada esta dependencia al archivo pom.xml de su proyecto:

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

Usuarios de Gradle

Añada esta dependencia al archivo build.gradle de su proyecto:

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

Uso

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

Inicialización

import com.unimtx.Uni;

public class Example {
    private static String ACCESS_KEY_ID = "tu id de clave de acceso";
    private static String ACCESS_KEY_SECRET = "tu secreto de clave de acceso";

    public static void main(String[] args) {
        Uni.init(ACCESS_KEY_ID, ACCESS_KEY_SECRET); // si usas el modo de autenticación simple, solo pasa el primer parámetro
    }
}

o puede configurar sus credenciales mediante 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íe un mensaje de texto a un solo destinatario.

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") // en formato E.164
            .setText("Tu código de verificación es 2048.");

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

Envíe un mensaje usando una plantilla con variables.

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

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

Enviar OTP

Envíe 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.

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

Verificar OTP

Verifique 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.

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") // el código proporcionado por el usuario
            .verify();

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