Documentación de la API

Versión de PHP recomendada: >= 7.0

La implementación con en lenguaje PHP se puede hacer de forma sencilla definiendo una función ayudante que haga la petición cURL de la siguiente forma:

function requestHelper($url, $post = false, $data = null, $headers = []) {
    $ch = curl_init();

    $opts = array(
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_TIMEOUT_MS => 0,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_SSL_VERIFYPEER => 0,
        CURLOPT_POST => $post
    );

    if ($data != null) {
        $opts += [CURLOPT_POSTFIELDS => $data];
    }

    if (count($headers)) {
        $opts += [CURLOPT_HTTPHEADER => $headers];
    }

    curl_setopt_array($ch, $opts);

    $result = curl_exec($ch);
    curl_close($ch);

    return $result;
}
                            

Ejemplo de envío de un SMS

Una vez definida la función, solo queda llamarla haciendo uso de la URL de la API de EnvíaTuSMS con el texto, el número y la cabecera HTTP, usando el método POST. Nótese que el parámetro $data el cual contiene el número y el mensaje, es un array asociativo que debe estar codificado en JSON para su envío:

$mensaje = "hola mundo";
$numeros = ["04120000000"]; // Obligatoriamente debe ser un array
$api_key = 'MI_API_KEY';
$url = "https://www.enviatusms.com/api/sms-multi?api_key={$api_key}";

$respuesta = requestHelper($url, true, json_encode(['numeros' => $numeros, 'texto' => $mensaje]), ['Content-Type' => 'application/json']);
                            

También es posible enviar un mensaje personalizado para cada número, cambiando la variable $mensajes por un array de mensajes. Nótese que la cantidad de mensajes debe coincidir con la cantidad de números, de lo contrario arrojará un error:

$mensajes = ["hola mundo 0412", "hola mundo 0414"];
$numeros = ["04120000000", "04140000000"]; // Obligatoriamente debe ser un array
$api_key = 'MI_API_KEY';
$url = "https://www.enviatusms.com/api/sms-multi?api_key={$api_key}";

$respuesta = requestHelper($url, true, json_encode(['numeros' => $numeros, 'texto' => $mensajes]), ['Content-Type' => 'application/json']);
                        

Lo cual arrojará una respuesta acorde a lo mencionado anteriormente.

Por último, la respuesta es un string codificado en JSON, por lo que hay que decodificarlo y hacer uso de él como un objeto:

$respuesta = json_decode($respuesta);

echo $respuesta->status;
echo $respuesta->msg;
                            

Ejemplo de consulta de balance

Haciendo uso de la misma función, podemos consultar el balance. La diferencia radica en los parámetros que le pasaremos a la llamada de la función.

La consulta de balance se hace con el método GET y no se necesita pasar datos o cabeceras adicionales. Nótese que el endpoint cambia en la URL:

$api_key = 'MI_API_KEY';
$url = "https://www.enviatusms.com/api/balance?api_key={$api_key}";
$respuesta = requestHelper($url);

$respuesta = json_decode($respuesta);

echo $respuesta->status;
echo $respuesta->creditos;
echo $respuesta->balance;
                            

Ejemplo de consulta de campaña

Haciendo uso de la misma función, podemos consultar los datos de una campaña. La diferencia radica en los parámetros que le pasaremos a la llamada de la función.

La consulta de campaña se hace con el método GET y solo se envía el id de la misma en la URL. Nótese que el endpoint cambia en la URL:

$api_key = 'MI_API_KEY';
$id_camp = 1;
$url = "https://www.enviatusms.com/api/campaign/{$id_camp}?api_key={$api_key}";
$respuesta = requestHelper($url);

$respuesta = json_decode($respuesta);

echo $respuesta->status;
echo $respuesta->message_text;