Запросить номер — API SMSCash
Выдаёт номер для регистрации на 20 минут.
SMSCashСправочник методов API
Запросить номер
Выдаёт номер для регистрации на 20 минут.
API-ключ в запросе
GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=mm&operator=alpha_gb| Параметр | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
| api_key | string | Обязательный | API-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer. | APIKEY |
| action | string | Обязательный | Название метода | getNumber |
| service | string | Обязательный | Код сервиса | mm |
| operator | string | Необязательный | Код поставщика или код оператора, привязанного к поставщику и стране. | alpha_gb |
| country | string | Необязательный | Код страны | 43 |
| provider_id | string | Необязательный | Код или числовой ID поставщика из getProviders. Если передан operator, поставщик должен совпадать. | 1 |
| session_duration | integer | Необязательный | Время ожидания SMS в минутах: от 1 до 1440. По умолчанию 20. | 20 |
| with_provider | integer | Необязательный | При значении 1 добавляет числовой ID поставщика в конец ответа. | 1 |
| Idempotency-Key | string | Необязательный | Уникальный ключ покупки: 8–128 латинских букв, цифр, символов _ . : -. Повтор с тем же ключом и параметрами возвращает ту же активацию. | order-2026-0001 |
Пример ответа
ACCESS_NUMBER:1000000000:447700900123operator=alpha — код поставщика из getProviders. Без country номер будет выбран из любой подходящей страны этого поставщика.
operator=alpha_gb — код оператора из getOperators. Он определяет поставщика и страну, поэтому country можно не передавать. Коды в этих примерах условные; используйте значения из справочников.
Если country указан вместе с кодом оператора, он должен соответствовать стране оператора. Иначе вернётся BAD_OPERATOR.
В country передавайте цифровой api_code из getCountries. Буквенный code тоже принимается. Регистр букв в кодах оператора и поставщика не важен.
Если operator не передан, система выберет подходящего поставщика. Числовой ID поставщика по-прежнему можно передать в operator.
После сетевого сбоя повторите запрос с тем же Idempotency-Key. Для новой покупки нужен новый ключ.
Для платного сервиса сумма резервируется при выдаче и списывается после кода. Для остальных сервисов вознаграждение начисляется после кода; доступность вывода зависит от срока поставщика.
ACCESS_NUMBER:1000000000:NUMBER — Номер успешно выдан.
Ошибки
BAD_KEY — Неверный, отозванный ключ или запрещённый IP. Проверьте ключ, доступ и IP-адрес сервера.
BANNED — Аккаунт заблокирован. Обратитесь в поддержку.
BAD_ACTION — Неизвестный метод или отсутствующий обязательный параметр. Исправьте action и обязательные параметры.
ERROR_RATE_LIMIT — Превышена частота или число одновременных запросов. Снизьте частоту и учтите Retry-After.
ERROR — Временная ошибка сервера. Примените задержку с увеличением интервала; выдачу повторяйте с тем же Idempotency-Key.
BAD_SERVICE — Сервис не найден или отключён. Выберите код из getServiceList.
BAD_COUNTRY — Страна не найдена, отключена или телефонный код неоднозначен. Передайте api_code или буквенный code из getCountries.
BAD_OPERATOR — Оператор не найден. Проверьте getProviders или getOperators.
BAD_DURATION — Неправильный срок активации. Укажите целое число минут от 1 до 1440.
NO_NUMBERS — Свободных номеров сейчас нет. Выберите другие условия или повторите позже.
NO_BALANCE — Недостаточно доступных средств. Проверьте баланс и резерв платных активаций.
IDEMPOTENCY_CONFLICT — Ключ покупки использован с другими параметрами. Сохраните параметры повтора или создайте новый ключ для новой покупки.
BAD_IDEMPOTENCY_KEY — Неверный формат ключа покупки. Используйте 8–128 разрешённых символов.
THROTTLED — Сработало ограничение выдачи для направления. Повторите после Retry-After.
KEY_DAILY_LIMIT — Дневной лимит ключа исчерпан. Дождитесь 00:00 UTC или изменения лимита.
USER_DAILY_LIMIT — Дневной лимит владельца исчерпан. Дождитесь 00:00 UTC или изменения лимита.
ROUTE_LIMIT — Достигнут лимит оператора, сервиса или позиции. Повторите после Retry-After; для настроенных расписаний учитывается часовой пояс страны.
SMS_LIMIT — Дневной лимит SMS на номер и сервис исчерпан. Выберите другой номер или дождитесь 00:00 UTC.