SMSC.ru HTTP API: Следить за балансом

Сценарий из mcp-everything. Актуально на 2026-10-24.

Не остаться без денег посреди рассылки.

1. Запроси баланс: GET /sys/balance.php с fmt = 3. С cur = 1 вернётся валюта счёта и кредит, если он есть.
2. Перед большой рассылкой посчитай её стоимость тем же запросом на отправку с cost = 1 и сравни с балансом.
3. Баланс можно запрашивать не чаще 10 раз в минуту — проверяй его по расписанию, а не перед каждым сообщением.

curl -G https://smsc.ru/sys/balance.php -d login=<логин> -d psw=<пароль> -d fmt=3

Базовые URL

• Боевой: https://smsc.ru
• Резервный: https://www2.smsc.ru

Авторизация

Тип: API-ключ

Параметры login и psw (пароль создаётся или меняется на странице паролей в кабинете) либо apikey вместо пары логин/пароль. Если в кабинете задан список разрешённых IP, запросы с других адресов отклоняются с ошибкой 2.

Методы сценария

GET /sys/balance.php — Баланс

Ответ при fmt=3: balance; при cur=1 и ненулевом кредите — credit, currency.

Параметр	Где	Тип	Обяз.	Описание
login	query	string	да	Логин (или apikey)
psw	query	string	да	Пароль
cur	query	integer	нет	Вернуть валюту счёта
fmt	query	integer	нет	0/1 строка, 2 XML, 3 JSON

Пример запроса:

https://smsc.ru/sys/balance.php?login=<login>&psw=<password>

Нюансы

• Одно SMS — 160 латинских или 70 кириллических символов; в составных — 153 и 67.
• Ошибка при fmt=0 — ERROR = N (описание), при fmt=1 — 0,-N, при fmt=3 — {"error": "...", "error_code": N}; для ошибок 3, 6, 7, 8 дополнительно возвращается id.
• Префиксы в тексте: __PING__, __CALL__, __HLR__, __auth__.
• Другие скрипты: /sys/templates.php (шаблоны), /sys/op_templates.php (шаблоны операторов), /sys/jobs.php (рассылки), /sys/ping.php (уведомления).

Другие сценарии

• Отправить SMS и узнать стоимость
• Проверить статус доставки
• Подтвердить номер через Mobile ID

---

Если этого недостаточно — официальная документация: https://smsc.ru/api/http/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/smsc.md