Добавить в стоплист
Последнее изменение: 16.04.2026
Если вы хотите добавить номер в стоплист, осуществите этот запрос:
Примеры запросов
https://sms.ru/stoplist/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&stoplist_phone=[номер телефона]&stoplist_text=[причина]&json=1
Пример ответа
При включенном параметре json=1:
{
"status": "OK", // Запрос выполнен успешно (нет ошибок в авторизации)
"status_code": 100, // Успешный код выполнения
}
Без json:
100 // Запрос выполнен
Параметры
| Параметр | Обязательный | Описание |
|---|---|---|
| stoplist_phone | да | Номер телефона, который необходимо добавить в стоплист |
| stoplist_text | да | Примечание к номеру (причина добавления в стоплист) |
| json=1 | рекомендуется | Данный параметр вызывает ответ сервера в формате JSON, в котором предоставлено больше данных об отправленных сообщениях |
Авторизация осуществляется при помощи:
| Параметр | Обязательный | Описание |
|---|---|---|
| api_id | да | Авторизацию по вашему уникальному ключу (api_id). Этот способ авторизации - самый удобный и приведен в примере выше. Ваш api_id вы можете найти на главной странице личного кабинета: [зарегистрируйтесь, чтобы получить api_id] |
Пример на PHP (со включенным модулем curl)
Мы настоятельно рекомендуем использовать нашу библиотеку под PHP. Данный код указан только в качестве простого примера.
$ch = curl_init("https://sms.ru/stoplist/add");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(
"api_id" => "[зарегистрируйтесь, чтобы получить api_id]",
"stoplist_phone" => "[номер телефона]", // Номер телефона, который необходимо добавить в стоплист
"stoplist_text" => "примечание", // Примечание к номеру
"json" => 1 // Для получения более развернутого ответа от сервера
));
$body = curl_exec($ch);
curl_close($ch);
$json = json_decode($body);
if ($json) { // Получен ответ от сервера
print_r($json); // Для дебага
if ($json->status == "OK") { // Запрос выполнился
// Запрос выполнен.
} else { // Запрос не выполнился (возможно ошибка авторизации, параметрах, итд...)
// Код ошибки: $json->status_code Текст ошибки: $json->status_text
}
} else { // Запрос не выполнился Не удалось установить связь с сервером
}
Пример на PHP без curl
Мы настоятельно рекомендуем использовать нашу библиотеку под PHP. Данный код указан только в качестве простого примера.
$body = file_get_contents("https://sms.ru/stoplist/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&stoplist_phone=[номер телефона]&stoplist_text=".urlencode("[причина]")."&json=1");
$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
Пример на curl
Если вы используете curl под Windows. То знак \ перед знаками ? и & необходимо убрать.
curl https://sms.ru/stoplist/add\?api_id=[зарегистрируйтесь, чтобы получить api_id]\&stoplist_phone=[номер телефона]\&stoplist_text=[причина]\&json=1