SDK Java da Unimatrix

Instalação

A maneira recomendada de instalar o SDK Unimatrix para Java é com uma ferramenta de gerenciamento de dependência como Maven ou Gradle, que está disponível no Maven Central.

Usuários Maven

Adicione esta dependência ao arquivo pom.xml do seu projeto:

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

Usuários Gradle

Adicione esta dependência ao arquivo build.gradle do seu projeto:

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

Uso

O exemplo a seguir mostra como usar o SDK Java da Unimatrix para interagir com os serviços da Unimatrix.

Inicialização

import com.unimtx.Uni;

public class Example {
    private static String ACCESS_KEY_ID = "seu id de chave de acesso";
    private static String ACCESS_KEY_SECRET = "seu segredo de chave de acesso";

    public static void main(String[] args) {
        Uni.init(ACCESS_KEY_ID, ACCESS_KEY_SECRET); // se usando o modo de autenticação simples, apenas passe o primeiro parâmetro
    }
}

ou você pode configurar suas credenciais por variáveis de ambiente:

export UNIMTX_ACCESS_KEY_ID=seu_id_de_chave_de_acesso
export UNIMTX_ACCESS_KEY_SECRET=seu_segredo_de_chave_de_acesso

Enviar SMS

Enviar uma mensagem de texto para um único destinatário.

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") // no formato E.164
            .setText("Seu código de verificação é 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);
        }
    }
}

Enviar uma mensagem usando um template com variáveis.

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

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

Enviar OTP

Enviar um código de passagem único (OTP) para um destinatário. O exemplo a seguir enviará um código de verificação gerado automaticamente para o usuário.

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

Verificar o código de passagem único (OTP) fornecido pelo usuário. O exemplo a seguir verificará se o código de verificação fornecido pelo usuário está correto.

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") // o código fornecido pelo usuário
            .verify();

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