SDK de Unimatrix para Rust

Instalación

La forma recomendada de instalar el SDK de Unimatrix para Rust es añadir el crate uni-sdk de crates.io al Cargo.toml de tu proyecto. El SDK requiere Rust 1.86 o posterior.

Añade el SDK asíncrono y Tokio a Cargo.toml:

[dependencies]
uni-sdk = "0.3"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Para una aplicación síncrona, habilita la función blocking:

[dependencies]
uni-sdk = { version = "0.3", features = ["blocking"] }

Uso

Inicializar un cliente

use uni_sdk::UniClient;

fn main() -> uni_sdk::Result<()> {
    let client = UniClient::new("your access key id", "your access key secret")?;
    Ok(())
}

También puedes configurar las credenciales mediante variables de entorno y usar UniClient::from_env():

export UNIMTX_ACCESS_KEY_ID=your_access_key_id
export UNIMTX_ACCESS_KEY_SECRET=your_access_key_secret

Enviar SMS

use uni_sdk::{SendMessageRequest, UniClient};

#[tokio::main]
async fn main() -> uni_sdk::Result<()> {
    let client = UniClient::from_env()?;
    let response = client.messages().send(&SendMessageRequest::text(
        "+1206880xxxx", // en formato E.164
        "Your verification code is 2048.",
    )).await?;
    println!("{:#?}", response.data);
    Ok(())
}

o usa el cliente bloqueante:

use uni_sdk::{blocking::UniClient, SendMessageRequest};

fn main() -> uni_sdk::Result<()> {
    let client = UniClient::from_env()?;
    let response = client.messages().send(&SendMessageRequest::text(
        "+1206880xxxx",
        "Your verification code is 2048.",
    ))?;

    println!("{:#?}", response.data);
    Ok(())
}

Enviar un código OTP

use uni_sdk::{SendOtpRequest, UniClient};

#[tokio::main]
async fn main() -> uni_sdk::Result<()> {
    let client = UniClient::from_env()?;
    let response = client.otp().send(&SendOtpRequest::new("+1206880xxxx")).await?;

    println!("{:#?}", response.data);
    Ok(())
}

Verificar un código OTP

use uni_sdk::{UniClient, VerifyOtpRequest};

#[tokio::main]
async fn main() -> uni_sdk::Result<()> {
    let client = UniClient::from_env()?;
    let response = client.otp().verify(&VerifyOtpRequest::new("+1206880xxxx", "123456")).await?;

    println!("{}", response.into_data()?.valid);
    Ok(())
}