# SMS.RU API: POST /sms/send — Отправка SMS

Можно и GET; при отправке более чем на 10 номеров используйте POST.

В JSON-ответе: `status`, `status_code`, `sms` (объект по номерам: `status`, `status_code`, `sms_id` или `status_text`), `balance`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `api_id` | query | string | да | Ключ API (или login + password) |
| `to` | query | string | да | Номера через запятую, до 100 за запрос; или форма to[номер]=текст |
| `msg` | query | string | да | Текст в UTF-8 |
| `json` | query | integer | нет | 1 — ответ в JSON (рекомендуется) |
| `from` | query | string | нет | Одобренное имя отправителя; по умолчанию — отправитель по умолчанию |
| `ip` | query | string | нет | IP конечного пользователя (для защиты от злоупотреблений) |
| `time` | query | integer | нет | Время отправки UNIX timestamp, до 2 месяцев вперёд |
| `ttl` | query | integer | нет | Время жизни сообщения в минутах, 1–1440 |
| `daytime` | query | integer | нет | 1 — учитывать часовой пояс получателя, ночью отложить до 10:00 (time игнорируется) |
| `translit` | query | integer | нет | 1 — перевести кириллицу в латиницу |
| `test` | query | integer | нет | 1 — имитация отправки без доставки и списания |
| `partner_id` | query | string | нет | Идентификатор партнёрской программы |

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

```
https://sms.ru/sms/send?api_id=[зарегистрируйтесь, чтобы получить api_id]&to=79255070602,74993221627&msg=hello+world&json=1
```

Пример ответа:

```json
https://sms.ru/sms/send?api_id=[зарегистрируйтесь, чтобы получить api_id]&to[79255070602]=hello+world&to[74993221627]=hello+world&json=1
```

## Базовые URL

- Боевой: `https://sms.ru`

## Авторизация

Тип: API-ключ

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

## Нюансы

- Без `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://mcp-everything.ru/integrations/sms-ru/scenarios/otpravit-sms-s-kodom-ili-uvedomleniem.md)

---

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