Documentación de la API

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;
                            

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 GET. 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-costo?api_key={$api_key}";

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

También es posible cotizar 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-costo?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->precio_usd;
                            

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;
                            

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;

                            

$link = "https://www.mi-enlace-a-acortar.com";
$api_key = 'MI_API_KEY';
$url = "https://www.enviatusms.com/api/acortar-url?api_key={$api_key}";

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

echo $respuesta->success;
echo $respuesta->link;