СМС API

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

• Отправить СМС
• Прием СМС
• Проверка статуса и стоимости СМС
• Отчет о доставке
• Текущий баланс
• Покупка и управление множеством номеров

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

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

Пример 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]";
	}

?>

• Наверх

Пример Python скрипта:

import urllib
import urllib.parse
import urllib.request
import ssl
url = "https://www.proovl.com/api/send.php?"
hdr = { 'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; Win64; x64)' }
params = {
'user': "user",
'token': "token",
'from': "from",
'to': "to",
'text': "text"}
try:
    _create_unverified_https_context = ssl._create_unverified_context
except AttributeError:
    pass
else:
    ssl._create_default_https_context = _create_unverified_https_context
query_string = urllib.parse.urlencode(params)
http_req = url + query_string
req = urllib.request.Request(http_req, headers=hdr)
f = urllib.request.urlopen(req)
freq = (f.read().decode('utf-8'))
x = freq.split(";")
g = x[1].replace("\"","")
y = x[0].replace("\"","")
if x[0] == "Error":
  print("Error message: ",x[1])
else:
  print("Message ID: ",x[1])
f.close()

• Наверх

Пример Java скрипта:

import java.net.*;
import java.io.*;
import java.io.IOException;

class sendsms {
  public static void main(String[] args) {
try {

  String charset = "UTF-8";
  String query = String.format("https://www.proovl.com/api/send.php?user=%s&token=%s&from=%s&text=%s&to=%s",
     URLEncoder.encode("user", charset),
     URLEncoder.encode("token", charset),
     URLEncoder.encode("from", charset),
     URLEncoder.encode("text", charset),
     URLEncoder.encode("to", charset));
  URL url = new URL(query);
  HttpURLConnection dd = (HttpURLConnection)url.openConnection();
  BufferedReader reader = new BufferedReader(new InputStreamReader(dd.getInputStream()));
  String output = reader.readLine();
  String[] parts = output.split(";");
 if (parts[0].equals("Error"))
        {
          System.out.println("Error message: " + parts[1]);
        }
 else {
           System.out.println("Message ID: " + parts[1]);
 }
       dd.disconnect();
      }
catch(Exception e){
       System.out.println(e);
    }
  }
}

• Наверх

Прием СМС

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

В случае, если Вы привязали Ваш СМС номер к 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 $text";
	} else {
		echo "Incorrect token";
		die;
	}

?>

• Наверх

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

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

Пример 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 Вашего скрипта по мере поступления обновлений.

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

<?php

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

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

• Наверх

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

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

Пример 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";

?>

• Наверх