Интеграция с сервисом (API)

API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды. Для упрощенной авторизации вместо пары логин и пароль можно использовать специальный API-ключ.
HTTP/HTTPS SMTP SMPP SOAP OMS SMS-команды Библиотеки и примеры кода

ОТПРАВКА СООБЩЕНИЙ

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

Комментарии в SMS-сообщениях

Отправка на группу номеров

Отправка HLR-запроса

Отправка e-mail сообщения

Отправка голосового сообщения (звонок)

Отправка viber-сообщения

Отправка сообщения в Telegram

Отправка сообщения в чат-бот Telegram

Использование префиксов при отправке сообщений

Управление шаблонами сообщений

Управление шаблонами операторов

Виртуальная отправка (режим тестирования)

Уведомления о событиях

УПРАВЛЕНИЕ РАССЫЛКАМИ

СТАТУСЫ СООБЩЕНИЙ

ПРОВЕРКА СОСТОЯНИЯ БАЛАНСА

УПРАВЛЕНИЕ КОНТАКТАМИ

УПРАВЛЕНИЕ КЛИЕНТАМИ

УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)

ПОЛУЧЕНИЕ ДАННЫХ

РАЗНОЕ

Создание и выгрузка счетов и актов

Для создания нового счета для субклиента необходимо вызвать методом GET или POST адрес: https://smsc.ru/sys/documents.php?add_account=1&login=<login>&psw=<password>&user=<user>&sum=<sum> либо: https://smsc.ru/sys/documents.php?add_account=1&login=<login>&psw=<password>&user_id=<user_id>&sum=<sum>
Для выгрузки существующего счета субклиента необходимо вызвать методом GET или POST адрес: https://smsc.ru/sys/documents.php?get_account=1&login=<login>&psw=<password>&user=<user>&id=<id> либо: https://smsc.ru/sys/documents.php?get_account=1&login=<login>&psw=<password>&user_id=<user_id>&id=<id>
Для выгрузки существующего акта субклиента необходимо вызвать методом GET или POST адрес: https://smsc.ru/sys/documents.php?get_act=1&login=<login>&psw=<password>&user=<user>&id=<id> https://smsc.ru/sys/documents.php?get_act=1&login=<login>&psw=<password>&user_id=<user_id>&id=<id> либо: https://smsc.ru/sys/documents.php?get_act=1&login=<login>&psw=<password>&user=<user>&num=<num> https://smsc.ru/sys/documents.php?get_act=1&login=<login>&psw=<password>&user_id=<user_id>&num=<num>
Серверу передаются следующие параметры:

ПараметрЗначение
loginЛогин Клиента.
pswПароль Клиента (можно добавить или изменить на данной странице).
apikeyСпециальный API-ключ, используемый для упрощенной авторизации вместо пары "логин+пароль" (можно создать на данной странице).
userЛогин субклиента, для которого необходимо создать или выгрузить счет. Вместо данного параметра можно использовать параметр user_id.
user_idИдентификатор субклиента, для которого необходимо создать или выгрузить счет. Вместо данного параметра можно использовать параметр user.
sumСумма, на которую необходимо создать счет в валюте Клиента.
serviceНазвание услуги, указываемой при создании счета.
idИдентификатор запрашиваемого счета или акта.
numНомер запрашиваемого акта.

В случае ошибки Сервер возвращает следующую строку:
    {
    "error": "описание",
    "error_code": N
    }
N – номер ошибки, может принимать следующие значения:

ЗначениеОписание
1Ошибка в параметрах.
2Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
4IP-адрес временно заблокирован.
5Ошибка создания счета.
6Сублогин не найден.
7Указанный документ не найден.
9Попытка отправки более одного запроса на создание или получение счета или акта в течение минуты.
Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).

В случае успешного запроса на создание счета Сервер возвращает multipart-структуру, включающую в себя 2 части с соответствующими заголовками. Первая часть содержит ответ Сервера в json-формате, содержащий идентификатор и сумму созданного счета, вторая часть включает в себя файл со счетом в pdf-формате.

В случае успешного запроса на получение счета Сервер возвращает файл со счетом в pdf-формате.

В случае успешного запроса на получение акта Сервер возвращает файл с актом в pdf-формате.

Сервер не принимает более одного запроса на создание или изменение счета или акта в течение минуты для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.