Помощь

• Альфа-номер - номер или альфа-имя отправителя, который отобразится у получателя Вашего SMS-сообщения.
• Название рассылки - название, которое вы присвоили своей рассылке.
• Текст сообщения - текст отправленного Вами сообщения.
• Дата и время отправки - дата и время отправки SMS-сообщения (время отправки Вашего SMS-сообщения и время получения этого SMS-сообщения получателем иногда может не совпадать, например, из-за большого количества абонентских номеров в вашей рассылке, загруженности телекоммуникационных сетей или загруженности сервера отправки SMS-сообщений).
• Кол-во телефонов - количество номеров телефонов в этой конкретной SMS-рассылке.
• Кол-во SMS - количество SMS-сообщений отправленных на один телефонный номер в данной SMS-рассылке.
• Статус рассылки - состояние в котором сейчас находится Ваша SMS-рассылка.
• Телефоны - список номеров телефонов в данной SMS-рассылке и дифференцированный статус доставки SMS-сообщений для них.
• Удаление - кнопка для удаления SMS-рассылки, ее возможно использовать, если сразу же после создания данной SMS-рассылки вы поняли, что совершили ошибку и хотите ее отменить (это возможно, если сервер SMS-рассыки еще не начал выполнять вашу SMS-рассылку).

API для создания пользовательских WEB-приложений

Переменные обязательны для заполнения (для php):

• $login - логин пользователя на портале sms.beltelecom.by
• $pass - пароль пользователя на портале sms.beltelecom.by
• $header - заголовок SMS-рассылки
• $text - текст SMS-рассылки
• $telefon - телефон(-ы) SMS-рассылки

Максимальный текст SMS-рассылки не должнен превышать 201 символ.

Превышающие ограничения cимволы будут обрезаны.

Каждый текст будет разбиваться на несколько SMS-сообщений.

В каждом SMS-сообщении 67 символов.

Дата и время отправки сообщения будет соответствовать дате и времени создания.

Формат телефонов : 375ххууууууу, при рассылке нескольких телефонов, они должны перечисляться через запятую.
Пример: "375ххууууууу,375ххууууууу,375ххууууууу,375ххууууууу,375ххууууууу"

Получение результата

После отправки запроса, абонент получает результат формата: 

{"state_author":" ","state_sms":" ","id_sms": }

,где:

• state_author - состояние аутентификации
• -1: пустой логин
• -2: пустой пароль
• -3: данные корректны
• -4: не верный логин\пароль
• -5: пользователь заблокирован
• state_sms - состояние рассылки
• -1: пустой заголовок
• -2: пустой текст
• -3: пустые телефоны
• -4: данные корректны
• -5: сервер недоступен
• id_sms - результат запроса
• -1: рассылка не сохранилась
• -(id): id сохраненной рассылки

PHP-скрипт для отправки SMS-сообщения

                    
                        <?
                        // Входные данные 
                            $login='';
                            $pass='';
                            $header="";
                            $text="";
                            $telefon="";
    
                            $data = array('login'=>$login,
                                    'password'=>$pass,
                                    'header'=>$header,
                                    'text'=>$text,
                                    'number'=>$telefon
                                    ); 
                            
                        $text = json_encode($data);         
                        $url = "https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php"; 
                        $ch = curl_init($url);  // инициализирует сеанс
                        // curl_setopt установка параметров для сеанса
                        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
                        curl_setopt($ch, CURLOPT_HEADER, 0);
                        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                                                'Content-Type: application/json' ,
                                                                'Content-Length: ' . strlen($text)));
                        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
                        curl_setopt($ch, CURLOPT_POSTFIELDS, $text);
                        $return = curl_exec($ch)."<br/>";
                        echo $return; 
                        curl_close($ch);  
                        ?>
                      
                    

Python-скрипт для отправки SMS-сообщения

                    
                        import requests
                        import json

                        url = "https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php"
                        data = {
                            "login": "Your_login",
                            "password": "Your_password",
                            "header": "Test Python script for API",
                            "text": "Test Python script for API",
                            "number": "Your_phone_number",
                        }
                        headers = {
                            'Content-Type': 'application/json',
                        }


                        def send_sms(url=url, data=data, headers=headers):
                            r = requests.post(
                                url,
                                data=json.dumps(data),
                                headers=headers
                            )
                            print(r.text)


                        if __name__ == '__main__':
                            send_sms()
                      
                    

JavaScript-скрипт для отправки SMS-сообщения

                    
                        const body = {
                            login: 'Your_login',
                            password: 'Your_password',
                            header: 'Test JS script for API',
                            text: 'Test JS script for API',
                            number: 'Your_phone_number'
                        };

                        fetch('https://sms.beltelecom.by/sites/all/modules/api_sms/xml.php', {
                            method: 'POST',
                            body: JSON.stringify(body),
                            headers: {
                                'Content-Type': 'application/json',
                            }
                        })
                            .then(response => response.json())
                            .then(json => {
                                console.log(json);
                            });