СМС API

Начать пользоваться нашим API очень просто. Вам не придется скачивать, распаковывать и устанавливать какие либо массивные библиотеки. Proovl СМС API представляет собой набор запросов для интеграции отправки и приема коротких текстовых сообщений в Ваше решение. Всего лишь нескольких строк кода из примеров приведенных ниже позволят Вам воспользоваться всеми преимуществами Proovl СМС.

Отправить СМС

Отправляйте СМС через наши высокоскоростные маршруты по всему миру.

ПараметрОписание
userID пользователя
tokenавторизационный ключ
routeмаршрут
1 = Стандартный; 2 = Экономный
fromтелефонный номер привязанный к вашему аккаунту
toномер получателя
textтекс сообщения
idID сообщения в нашей сети
statusтекущий статус сообщения
Пример PHP скрипта:
<?php

// Запрос отправки

$url = "https://www.proovl.com/api/send.php";

$postfields = array(
'user' => "$user",
'token' => "$token",
'route' => "$route",
'from' => "$from",
'to' => "$to",
'text' => "$text"
);

if (!$curld = curl_init()) {
exit;
}

curl_setopt($curld, CURLOPT_POST, true);
curl_setopt($curld, CURLOPT_POSTFIELDS, $postfields);
curl_setopt($curld, CURLOPT_URL,$url);
curl_setopt($curld, CURLOPT_RETURNTRANSFER, true);

$output = curl_exec($curld);

curl_close ($curld);



// Обработка ответа

$result = explode(';',$output);

if ($result[0] == "Error") {
echo "Error message: $result[1]";
die;
} else {
echo "Message ID: $result[1]; Status: $result[0]";
}

?>

Прием СМС

Каждое входящее сообщение будет перенаправлено HTTP запросом на URL скрипта, в случае если был выбран соответствующий сценарий. Запрос будет содержать следующие параметры.

ПараметрОписание
tokenавторизационный ключ
idID сообщения в нашей сети
fromномер отправителя
toномер получателя
textтекст сообщения

В случае, если Вы привязали Ваш СМС номер к e-mail, мы перенаправим все входящие сообщения на вашу электронную почту с указанием номера отправителя и номера получателя.

Если Вы выбрали перенаправление сообщений на другой номер телефона, наша система перенаправит СМС с номером отправителя в начале текста сообщения.

Пример PHP скрипта:
<?php

$id = $_REQUEST['id'];
$token = $_REQUEST['token'];
$from = $_REQUEST['from'];
$to = $_REQUEST['to'];
$text = $_REQUEST['text'];

if ($token == "[your_token]") {
echo "Thank you $from for sending $message";
} else {
echo "Incorrect token";
die;
}

?>

Проверка статуса и стоимости СМС

Позволяет запрашивать текущий статус и стоимость сообщения в нашей системе.

ПараметрОписание
idID сообщения в нашей сети
phoneтелефонный номер привязанный к вашему аккаунту
statusтекущий статус сообщения
priceцена сообщения
Пример PHP скрипта:
<?php

$id = $_REQUEST['id'];
$phone = $_REQUEST['phone'];

// Запрос отправки

$url = "https://www.proovl.com/api/check.php";

$postfields = array(
'id' => "$id",
'phone' => "$phone"
);

if (!$curld = curl_init()) {
exit;
}

curl_setopt($curld, CURLOPT_POST, true);
curl_setopt($curld, CURLOPT_POSTFIELDS, $postfields);
curl_setopt($curld, CURLOPT_URL,$url);
curl_setopt($curld, CURLOPT_RETURNTRANSFER, true);

$output = curl_exec($curld);

curl_close ($curld);



// Обработка ответа

$result = explode(';',$output);

if ($result[0] == "Error") {
echo "Error message: $result[1]";
die;
} else {
echo "Message ID: $result[0]; Status: $result[1]; Price: $result[2]";
}

?>

Отчет о доставке

Система высылает информацию о доставке сообщения на URL Вашего скрипта по мере поступления обновлений.

ПараметрОписание
idID сообщения в нашей сети
tokenавторизационный ключ
statusтекущий статус сообщения
(Sent; Delivered; Failed; Undelivered)
Пример PHP скрипта:
<?php

$id = $_REQUEST['id'];
$token = $_REQUEST['token'];
$status = $_REQUEST['status'];

echo "Message ID: $id is: $status";
?>

Текущий баланс

Позволяет запрашивать текущий баланс.

ПараметрОписание
userID пользователя
tokenавторизационный ключ
Пример PHP скрипта:
<?php

$user = $_REQUEST['user'];
$token = $_REQUEST['token'];

$balance = file_get_contents("https://www.proovl.com/api/balance.php?user=$user&token=$token");

echo "Your account balance: $balance";

?>