+375 (29) 658-00-43

Разработчикам

RocketSMS предоставляет HTTP API для интеграции SMS-рассылок в ваши проекты, а также SMPP-протокол для высоконагруженных сценариев. Всё, что нужно — зарегистрироваться в сервисе и получить API-доступ.

Быстрый старт

Для отправки SMS через API достаточно выполнить POST-запрос к эндпоинту. Ваш логин и пароль от личного кабинета RocketSMS используются для аутентификации.

Эндпоинт: https://api.rocketsms.by/json/send

Метод: POST

Формат данных: application/x-www-form-urlencoded

Параметры запроса:

  • username — логин (УНП) от личного кабинета
  • password — пароль от личного кабинета
  • phone — номер получателя в международном формате (например, 375296580043)
  • text — текст сообщения
  • sender — альфа-имя (опционально)

Ответ: JSON

  • Успех: {"id": 123456789} — идентификатор сообщения
  • Ошибка: {"error": 123} — код ошибки

Точки подключения

Для отправки запросов используйте одну из точек подключения в зависимости от вашего региона:

Хост Когда использовать
api.rocketsms.by Основная точка. Подходит большинству клиентов.
Если ваш случай не описан ниже — используйте эту точку.
api-by.rocketsms.by Альтернативная точка для Беларуси.
Рекомендуем для подключения из «защищённых сегментов» ДЦ БТК либо МТС.
api.rocketsms.pl Альтернативная точка для подключения из ЕС.
Рекомендуем для клиентов и серверов, расположенных в Европе.
api.rocketsms.ru Альтернативная точка для подключения из РФ.
Используйте при нестабильной работе основной точки из России.

Примеры кода

Python

import requests

def send_sms(login, password, phone, text):
    response = requests.post('https://api.rocketsms.by/json/send', data={
        'username': login,
        'password': password,
        'phone': phone,
        'text': text,
    })
    result = response.json()
    if 'id' in result:
        print(f'Сообщение отправлено. ID: {result["id"]}')
    elif 'error' in result:
        print(f'Ошибка: {result["error"]}')

send_sms('your_login', 'your_password', '375296580043', 'Привет!')

JavaScript (Node.js)

async function sendSms(login, password, phone, text) {
    const params = new URLSearchParams({
        username: login,
        password: password,
        phone: phone,
        text: text,
    });

    const response = await fetch('https://api.rocketsms.by/json/send', {
        method: 'POST',
        body: params,
    });

    const result = await response.json();
    if (result.id) {
        console.log('Сообщение отправлено. ID:', result.id);
    } else if (result.error) {
        console.log('Ошибка:', result.error);
    }
}

sendSms('your_login', 'your_password', '375296580043', 'Привет!');

Go

package main

import (
    "net/http"
    "net/url"
    "encoding/json"
    "fmt"
    "io"
)

func sendSms(login, password, phone, text string) {
    resp, err := http.PostForm("https://api.rocketsms.by/json/send",
        url.Values{"username": {login}, "password": {password},
                   "phone": {phone}, "text": {text}})
    if err != nil { fmt.Println("Ошибка:", err); return }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    var result map[string]interface{}
    json.Unmarshal(body, &result)

    if id, ok := result["id"]; ok {
        fmt.Println("Сообщение отправлено. ID:", id)
    } else if errMsg, ok := result["error"]; ok {
        fmt.Println("Ошибка:", errMsg)
    }
}

func main() {
    sendSms("your_login", "your_password", "375296580043", "Привет!")
}

PHP

<?php

function sendSms($login, $password, $phone, $text) {
    $curl = curl_init('https://api.rocketsms.by/json/send');
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, [
        'username' => $login,
        'password' => $password,
        'phone'    => $phone,
        'text'     => $text,
    ]);

    $result = json_decode(curl_exec($curl), true);

    if (isset($result['id'])) {
        echo "Сообщение отправлено. ID: {$result['id']}";
    } elseif (isset($result['error'])) {
        echo "Ошибка: {$result['error']}";
    }
}

sendSms('your_login', 'your_password', '375296580043', 'Привет!');

cURL (командная строка)

curl -X POST https://api.rocketsms.by/json/send \
    -d "username=your_login" \
    -d "password=your_password" \
    -d "phone=375296580043" \
    -d "text=Привет!"

Готовые интеграции

Для популярных CMS и CRM доступны готовые модули — установка займёт несколько минут:

Полный список — в каталоге готовых интеграций.

SMPP-подключение

RocketSMS поддерживает SMPP-протокол версии 3.4. Подключение доступно после заключения договора, без минимального объёма отправки.

Важно: SMPP у нас работает с ограничениями — максимум одно одновременное подключение, при bind обязательно указывать system_type (иначе bind_error). Для большинства задач мы рекомендуем HTTP API — он быстрее, стабильнее и проще в интеграции.

SMPP обычно используют таксопарки и логистические компании, чьё ПО умеет работать только по этому протоколу. В остальных случаях HTTP API удобнее во всех смыслах.

Для подключения SMPP свяжитесь с вашим персональным менеджером или напишите в поддержку.

Полезные ссылки