{"name":"SMSC.ru HTTP API","vendor":"SMSC.ru","industry":"communications","summary":"HTTP/HTTPS API сервиса рассылок SMSC.ru. Через один скрипт отправки уходят SMS, MMS, бинарные и flash-сообщения, HLR- и ping-запросы, email, голосовые сообщения, Viber, Telegram и WhatsApp. Также есть проверка статуса, баланса и стоимости, шаблоны, рассылки (jobs) и подтверждение Mobile ID. Формат ответа задаётся параметром `fmt` (строка, числа, XML или JSON).","docsUrl":"https://smsc.ru/api/http/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"otpravit-sms-i-uznat-stoimost","title":"Отправить SMS и узнать стоимость","summary":"Коды подтверждения, уведомления о заказах и рассылки через SMSC.ru.","steps":["Возьми логин и пароль для API (страница паролей в кабинете) или apikey. Если в кабинете задан список разрешённых IP, запросы с других адресов вернут ошибку 2.","Чтобы узнать цену без отправки, сделай тот же запрос с cost = 1: GET /sys/send.php с phones и mes. Для отправки с возвратом стоимости и баланса — cost = 3.","Отправь: GET /sys/send.php (или POST) с login, psw, phones (через запятую, в международном формате), mes, sender (зарегистрированное имя), charset = utf-8 и fmt = 3 — ответ в JSON. Без charset текст считается в windows-1251.","В ответе id и cnt (число SMS). Сохрани id: по нему проверяется статус. Ошибка приходит как {\"error\": ..., \"error_code\": N}: 3 — нет денег, 6 — сообщение запрещено, 7 — неверный номер.","Если удобнее JSON в теле запроса, те же параметры принимает POST /rest/send/."],"code":"curl -G https://smsc.ru/sys/send.php \\\n  -d login=<логин> -d psw=<пароль> \\\n  -d phones=79991234567 \\\n  --data-urlencode 'mes=Код подтверждения: 4821' \\\n  -d sender=<имя отправителя> -d charset=utf-8 -d fmt=3 -d cost=3","language":"bash","methods":["GET /sys/send.php","POST /rest/send/"]},{"id":"proverit-status-dostavki","title":"Проверить статус доставки","summary":"Узнать, доставлено ли сообщение, — для повторной отправки или отчёта.","steps":["Запроси статус: GET /sys/status.php с phone и id отправленного сообщения (несколько — через запятую в одинаковом порядке) и fmt = 3.","С all = 1 вернётся полная информация, с all = 2 — ещё страна, оператор и регион.","Статус доступен в течение суток после отправки, потом сообщения уходят в архив.","Не опрашивай чаще лимита: не больше 5 одинаковых запросов по одному сообщению в минуту."],"code":"curl -G https://smsc.ru/sys/status.php \\\n  -d login=<логин> -d psw=<пароль> \\\n  -d phone=79991234567 -d id=<id сообщения> -d fmt=3 -d all=1","language":"bash","methods":["GET /sys/status.php"]},{"id":"sledit-za-balansom","title":"Следить за балансом","summary":"Не остаться без денег посреди рассылки.","steps":["Запроси баланс: GET /sys/balance.php с fmt = 3. С cur = 1 вернётся валюта счёта и кредит, если он есть.","Перед большой рассылкой посчитай её стоимость тем же запросом на отправку с cost = 1 и сравни с балансом.","Баланс можно запрашивать не чаще 10 раз в минуту — проверяй его по расписанию, а не перед каждым сообщением."],"code":"curl -G https://smsc.ru/sys/balance.php -d login=<логин> -d psw=<пароль> -d fmt=3","language":"bash","methods":["GET /sys/balance.php"]},{"id":"podtverdit-nomer-cherez-mobile-id","title":"Подтвердить номер через Mobile ID","summary":"Подтверждение номера телефона кодом от сервиса Mobile ID.","steps":["Отправь запрос подтверждения: GET /sys/send.php с phones = номер пользователя и mes = __auth__.","Пользователь получит код. Попроси его ввести код на сайте.","Проверь код: GET /sys/mob_id.php с phone и code. Если код верный, номер подтверждён."],"code":"curl -G https://smsc.ru/sys/send.php -d login=<логин> -d psw=<пароль> -d phones=79991234567 -d mes=__auth__ -d fmt=3\ncurl -G https://smsc.ru/sys/mob_id.php -d login=<логин> -d psw=<пароль> -d phone=79991234567 -d code=<код>","language":"bash","methods":["GET /sys/send.php","GET /sys/mob_id.php"]}],"baseUrls":[{"label":"Боевой","url":"https://smsc.ru"},{"label":"Резервный","url":"https://www2.smsc.ru"}],"auth":{"type":"api_key","description":"Параметры `login` и `psw` (пароль создаётся или меняется на странице паролей в кабинете) либо `apikey` вместо пары логин/пароль. Если в кабинете задан список разрешённых IP, запросы с других адресов отклоняются с ошибкой 2.","example":""},"methods":[{"id":"GET /sys/send.php","title":"Отправка сообщений","httpMethod":"GET","path":"/sys/send.php","description":"Можно и POST. Обязательны `login`, `psw` и `phones` + `mes` (или `list`).\n\nРасчёт стоимости без отправки — тот же запрос с `cost=1`.\n\nОтвет при `fmt=3`: `cost=0` — `id`, `cnt`; `cost=1` — `cost`, `cnt`; `cost=2` — `id`, `cnt`, `cost`; `cost=3` — плюс `balance`.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин (или apikey)"},{"name":"psw","in":"query","type":"string","required":true,"description":"Пароль"},{"name":"phones","in":"query","type":"string","required":true,"description":"Номера в международном формате через запятую или точку с запятой; также коды групп G<номер>, email, ник Telegram"},{"name":"mes","in":"query","type":"string","required":true,"description":"Текст, до 1000 символов"},{"name":"id","in":"query","type":"string","required":false,"description":"ID сообщения клиента: число 1–2147483647 или строка до 40 символов"},{"name":"sender","in":"query","type":"string","required":false,"description":"Зарегистрированное имя отправителя, до 11 символов или 15 цифр"},{"name":"fmt","in":"query","type":"integer","required":false,"description":"Формат ответа: 0 строка, 1 числа, 2 XML, 3 JSON"},{"name":"cost","in":"query","type":"integer","required":false,"description":"0 отправить, 1 только стоимость, 2 отправить и вернуть стоимость, 3 + баланс"},{"name":"charset","in":"query","type":"string","required":false,"description":"utf-8 или koi8-r (по умолчанию windows-1251)"},{"name":"translit","in":"query","type":"integer","required":false,"description":"0 нет, 1 translit, 2 mpaHc/Ium"},{"name":"tinyurl","in":"query","type":"integer","required":false,"description":"1 — сокращать ссылки"},{"name":"time","in":"query","type":"string","required":false,"description":"Время отправки: DDMMYYhhmm, DD.MM.YY hh:mm, h1-h2, 0ts, +m"},{"name":"tz","in":"query","type":"string","required":false,"description":"Часовой пояс относительно Москвы"},{"name":"period","in":"query","type":"number","required":false,"description":"Растянуть рассылку на 0.1–720 часов (с freq)"},{"name":"freq","in":"query","type":"integer","required":false,"description":"Интервал между частями рассылки, 1–1440 минут"},{"name":"valid","in":"query","type":"string","required":false,"description":"Срок жизни: 1–24 часа или чч:мм"},{"name":"maxsms","in":"query","type":"integer","required":false,"description":"Максимум частей в сообщении"},{"name":"list","in":"query","type":"string","required":false,"description":"Пакет номер:сообщение, по одному в строке (%0A)"},{"name":"flash","in":"query","type":"integer","required":false,"description":"1 — Flash SMS"},{"name":"hlr","in":"query","type":"integer","required":false,"description":"1 — HLR-запрос без отправки SMS"},{"name":"ping","in":"query","type":"integer","required":false,"description":"1 — ping-SMS (невидимое)"},{"name":"call","in":"query","type":"integer","required":false,"description":"1 — голосовое сообщение"},{"name":"voice","in":"query","type":"string","required":false,"description":"Голос: m, m2, m3, m4, w, w2, w3, w4"},{"name":"mail","in":"query","type":"integer","required":false,"description":"1 — email (нужны subj и sender)"},{"name":"subj","in":"query","type":"string","required":false,"description":"Тема MMS или email"},{"name":"viber","in":"query","type":"integer","required":false,"description":"1 — Viber"},{"name":"tg","in":"query","type":"integer","required":false,"description":"1 — код подтверждения в Telegram (4–8 цифр в mes)"},{"name":"bot","in":"query","type":"string","required":false,"description":"Бот: Telegram @botname_bot, WhatsApp wa:номер"},{"name":"fileurl","in":"query","type":"string","required":false,"description":"URL прикрепляемого файла"},{"name":"err","in":"query","type":"integer","required":false,"description":"1 — вернуть номера с ошибками"},{"name":"op","in":"query","type":"integer","required":false,"description":"1 — вернуть по номерам mccmnc, стоимость, статус, ошибку"},{"name":"userip","in":"query","type":"string","required":false,"description":"IP пользователя для лимита сообщений на IP"}],"requestExample":"https://smsc.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello!","responseExample":"https://smsc.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=<message>&cost=1","docsUrl":""},{"id":"POST /rest/send/","title":"Отправка с параметрами в JSON","httpMethod":"POST","path":"/rest/send/","description":"Те же параметры, что у `send.php`, передаются JSON-объектом в теле запроса.","params":[{"name":"login","in":"body","type":"string","required":true,"description":"Логин (или apikey)"},{"name":"psw","in":"body","type":"string","required":true,"description":"Пароль"},{"name":"phones","in":"body","type":"string","required":true,"description":"Номера получателей"},{"name":"mes","in":"body","type":"string","required":true,"description":"Текст сообщения"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /sys/status.php","title":"Статус сообщения","httpMethod":"GET","path":"/sys/status.php","description":"Можно и POST. Статус запрашивается в течение суток после отправки, затем сообщения уходят в архив.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин (или apikey)"},{"name":"psw","in":"query","type":"string","required":true,"description":"Пароль"},{"name":"phone","in":"query","type":"string","required":true,"description":"Номер или номера через запятую (в порядке id)"},{"name":"id","in":"query","type":"string","required":true,"description":"ID сообщения или список через запятую"},{"name":"fmt","in":"query","type":"integer","required":false,"description":"0 строка, 1 статус и время через запятую, 2 XML, 3 JSON"},{"name":"all","in":"query","type":"integer","required":false,"description":"1 — полная информация, 2 — плюс страна, оператор, регион"},{"name":"bot","in":"query","type":"integer","required":false,"description":"1 — статус сообщения в Telegram-бот"},{"name":"del","in":"query","type":"integer","required":false,"description":"1 — удалить отправленное сообщение"},{"name":"charset","in":"query","type":"string","required":false,"description":"utf-8 или koi8-r"}],"requestExample":"https://smsc.ru/sys/status.php?login=<login>&psw=<password>&phone=<phone>&id=<sms_id>","responseExample":"","docsUrl":""},{"id":"GET /sys/balance.php","title":"Баланс","httpMethod":"GET","path":"/sys/balance.php","description":"Ответ при `fmt=3`: `balance`; при `cur=1` и ненулевом кредите — `credit`, `currency`.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин (или apikey)"},{"name":"psw","in":"query","type":"string","required":true,"description":"Пароль"},{"name":"cur","in":"query","type":"integer","required":false,"description":"Вернуть валюту счёта"},{"name":"fmt","in":"query","type":"integer","required":false,"description":"0/1 строка, 2 XML, 3 JSON"}],"requestExample":"https://smsc.ru/sys/balance.php?login=<login>&psw=<password>","responseExample":"","docsUrl":""},{"id":"GET /sys/mob_id.php","title":"Подтверждение кода Mobile ID","httpMethod":"GET","path":"/sys/mob_id.php","description":"Запрос Mobile ID отправляется через `send.php` с `mes=__auth__`; код подтверждается этим скриптом.","params":[{"name":"login","in":"query","type":"string","required":true,"description":"Логин"},{"name":"psw","in":"query","type":"string","required":true,"description":"Пароль"},{"name":"phone","in":"query","type":"string","required":true,"description":"Номер"},{"name":"code","in":"query","type":"string","required":true,"description":"Код"}],"requestExample":"https://smsc.ru/sys/mob_id.php?login=<login>&psw=<password>&phone=<phone>&code=<code>","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"1","description":"Ошибка в параметрах"},{"code":"2","description":"Неверный логин или пароль, либо IP не в списке разрешённых"},{"code":"3","description":"Недостаточно средств"},{"code":"4","description":"IP временно заблокирован из-за частых ошибок"},{"code":"5","description":"Неверный формат даты"},{"code":"6","description":"Сообщение запрещено (по тексту или имени отправителя)"},{"code":"7","description":"Неверный формат номера"},{"code":"8","description":"Сообщение не может быть доставлено на номер"},{"code":"9","description":"Дубль запроса или 15 и более одновременных запросов"}],"limits":"- Текст — до 1000 символов.\n- Одинаковый запрос на отправку — не чаще раза в минуту; запросов стоимости — до 5 одинаковых в минуту.\n- 15 и более одновременных запросов под одним логином — ошибка 9.\n- Баланс — не больше 10 запросов в минуту.\n- Статус — не больше 5 одинаковых запросов по сообщению и одного пакетного запроса в минуту.\n- Больше 50 сообщений одному абоненту с интервалом меньше 60 секунд блокируются.","gotchas":["Одно 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` (уведомления)."],"slug":"smsc","version":2,"updatedAt":"2026-10-24T17:05:37.098Z","sources":[{"title":"SMSC.ru — HTTP API","url":"https://smsc.ru/api/http/","kind":"research","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"Отправка сообщений","url":"https://smsc.ru/api/http/send/","kind":"research","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"Проверка статуса","url":"https://smsc.ru/api/http/status_messages/check_status/","kind":"research","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"Коды статусов","url":"https://smsc.ru/api/http/status_messages/statuses","kind":"research","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"Баланс","url":"https://smsc.ru/api/http/balance/","kind":"research","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-19T13:42:10.954Z"},{"title":"scenarios-smsc.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:27.246Z"}],"logoUrl":null}