Повторно получить номер — API SMSCash
Создаёт новую активацию на ранее выданный вам номер.
SMSCashСправочник методов API
Повторно получить номер
Создаёт новую активацию на ранее выданный вам номер.
API-ключ в запросе
GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=getRepeatNumber&service=mm&number=447700900123&country=43| Параметр | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
| api_key | string | Обязательный | API-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer. | APIKEY |
| action | string | Обязательный | Название метода | getRepeatNumber |
| service | string | Обязательный | Код сервиса | mm |
| operator | string | Необязательный | Код поставщика или код оператора, привязанного к поставщику и стране. | alpha_gb |
| number | string | Обязательный | Номер из предыдущей активации, с плюсом или без него. | 447700900123 |
| 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:1000000001:447700900123Предыдущая активация должна завершиться. Номер и предыдущая активация должны принадлежать тому же API-ключу.
Страна и оператор наследуются от номера. Другой сервис можно указать явно. Проверяются обычные цены, баланс и лимиты.
operator=alpha — код поставщика из getProviders. Без country номер будет выбран из любой подходящей страны этого поставщика.
operator=alpha_gb — код оператора из getOperators. Он определяет поставщика и страну, поэтому country можно не передавать. Коды в этих примерах условные; используйте значения из справочников.
Если country указан вместе с кодом оператора, он должен соответствовать стране оператора. Иначе вернётся BAD_OPERATOR.
В country передавайте цифровой api_code из getCountries. Буквенный code тоже принимается. Регистр букв в кодах оператора и поставщика не важен.
Ошибки
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.
NO_ACTIVATION — Активация не найдена в доступе этого ключа. Проверьте id и ключ, которым получен номер.
BAD_NUMBER — Неправильный номер. Передайте 6–15 цифр; ведущий + допускается.
BAD_ROUTE — Номер принадлежит другой стране или оператору. Сохраните маршрут исходной активации.
NUMBER_IN_USE — Номер уже занят активацией или удержанием другого клиента. Дождитесь завершения текущей активации.