SendMobile/CheckCode - Enviar por SMS un Token de Validación


Para realizar un envío de un SMS Token Segurity por medio de la API primero debe tener generado un token de acceso valido.

Una vez que su aplicación disponga de un token de acceso puede utilizar el EndPoint de la API llamado "/api/SendMobile/sms/send/checkcode".

Para acceder a dicha funcionalidad su aplicación debe enviar mediante POST las siguientes variables válidas:


  • email: Indica el email o usuario que fue proporcionado para utilizar los sistemas web. 
  • password: Indica la contraseña que utiliza para acceder a los sistemas web. 
  • organization_id: Indica el código de su Empresa/Organización. 
  • department_id: Indica el código de su Departamento/Sector. 
  • destinatario: Debe indicar el número de celular con código de país y área a enviar el Token SMS. 
  • mensaje: Puede indicar el mensaje que desea utilizar para enviar. En el mensaje debe incluir el string $$CODIGO$$ el cual será reemplazado por el token automáticamente generado por el sistema. 
El siguiente código indica un ejemplo de como puede ser consumida un validación de email desde el lenguaje PHP:


$body = "email=suusuario&password=sucontraseña&organization_id=suidempresa&department_id=suidsector&destinatario=1150001111&mensaje=Le enviamos el valor de seguridad:$$CODIGO$$";

$ch = curl_init();
$headr = array();
$headr[] = 'Content-type: application/x-www-form-urlencoded';
$headr[] = 'Authorization: Bearer '.$tokenaccess; // --> Variable con Token Valido Generado

curl_setopt($ch, CURLOPT_URL, "http://api.certisend.com/api/SendMobile/sms/send/checkcode");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headr);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
$result = curl_exec($ch);


echo $result . "<br><br>";

Respuesta:

El sistema retornara una respuesta seteada según las siguientes variables:

state= Estado de la solicitud: 1-OK 0-Error
desc= Descripción del Error.
id= Id interno de la solicitud.
cod= Valor numerico generado y enviado como token para verificar.

Ejemplo de Respuesta:

{"state":"1","cod":"5488","id":"0"}

¿Le ha resultado útil este artículo?