SDK de Unimatrix para PHP

Instalación

Usar Composer es la forma recomendada de instalar el SDK de Unimatrix para PHP, que está disponible en Packagist.

Ejecute el siguiente comando para agregar unimtx/uni-sdk como una dependencia a su proyecto:

composer require unimtx/uni-sdk

Uso

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

Inicializar un cliente

use Uni\UniClient;

$client = new UniClient([
  'accessKeyId' => 'tu id de clave de acceso',
  'accessKeySecret' => 'tu secreto de clave de acceso' // si usas el modo de autenticación simple, elimina esta línea
]);

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

Enviar un mensaje de texto a un solo destinatario.

use Uni\UniClient;
use Uni\UniException;

$client = new UniClient();

try {
  $resp = $client->messages->send([
    'to' => '+1206880xxxx', // en formato E.164
    'text' => 'Tu código de verificación es 2048.'
  ]);
  var_dump($resp->data);
} catch (UniException $e) {
  print_r($e);
}

Enviar un mensaje usando una plantilla con variables.

$client->messages->send([
  'to' => '+1650253xxxx',
  'signature' => 'Unimatrix',
  'templateId' => 'pub_otp_es',
  'templateData' => [
    'code' => '2048'
  ]
]);

Enviar OTP

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

use Uni\UniClient;
use Uni\UniException;

$client = new UniClient();

$resp = $client->otp->send([
  'to' => '+1206880xxxx'
]);
var_dump($resp->data);

Verificar OTP

Verificar el código de paso único (OTP) que un usuario proporcionó. El siguiente ejemplo comprobará si el código de verificación proporcionado por el usuario es correcto.

use Uni\UniClient;
use Uni\UniException;

$client = new UniClient();

$resp = $client->otp->verify([
  'to' => '+1206880xxxx',
  'code' => '123456' // el código proporcionado por el usuario
]);
var_dump($resp->valid);