SMS.RU API: Узнать, доставлено ли сообщение

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

Проверить, дошло ли SMS, — опросом или вебхуком.

1. Разово: GET /sms/status с sms_id (до 100 через запятую). В ответе для каждого — status_code, status_text и cost. 103 — доставлено, 104 — не доставлено, истекло время жизни.
2. Постоянно: зарегистрируй обработчик статусов — GET /callback/add с url твоего скрипта (URL-кодированным). Так документация рекомендует вместо опроса.
3. SMS.RU будет присылать POST-запросы со статусами всех отправленных сообщений. Обработчик должен ответить строкой 100, иначе запрос будет повторяться.
4. Если ответ 901 — неверный URL обработчика.

# Статус двух сообщений
curl -G https://sms.ru/sms/status \
  -d api_id=<api_id> \
  -d sms_id=000000-10000000,000000-10000001 \
  -d json=1

# Обработчик статусов
curl -G https://sms.ru/callback/add \
  -d api_id=<api_id> \
  --data-urlencode 'url=https://example.ru/smsru/callback' \
  -d json=1

Базовые URL

• Боевой: https://sms.ru

Авторизация

Тип: API-ключ

Рекомендуемый способ — параметр api_id (выдаётся на главной странице личного кабинета). Альтернатива — login (номер телефона) и password; в этом случае обязательно HTTPS.

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

GET /sms/status — Статус сообщений

В JSON-ответе для каждого sms_id: status, status_code, cost, status_text.

Параметр	Где	Тип	Обяз.	Описание
api_id	query	string	да	Ключ API
sms_id	query	string	да	ID сообщений через запятую, до 100
json	query	integer	нет	1 — ответ в JSON

GET /callback/add — Добавление обработчика вебхуков

Обработчик получает статусы отправленных сообщений.

Параметр	Где	Тип	Обяз.	Описание
api_id	query	string	да	Ключ API
url	query	string	да	Адрес обработчика (URL-кодированный при GET)
json	query	integer	нет	1 — ответ в JSON

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

https://sms.ru/callback/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&url=https%3A%2F%2Fyoursite.ru%2Fcallback.php&json=1

Нюансы

• Без json=1 ответ — текстовые строки (код запроса, затем данные построчно).
• Вместо опроса sms/status и callcheck/status документация рекомендует вебхуки.
• Есть также callback/del, callback/get, stoplist/del, stoplist/get, auth/check, отправка через email/SMTP; PHP-библиотека — https://sms.ru/php.

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

• Отправить SMS с кодом или уведомлением
• Подтвердить номер телефона звонком
• Следить за балансом и лимитами

---

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