Изменить статус активации — API SMSCash
Запрашивает повторную SMS, завершает активацию или отменяет её. Отмена доступна через две минуты после выдачи номера.
SMSCashСправочник методов API
Изменить статус активации
Запрашивает повторную SMS, завершает активацию или отменяет её. Отмена доступна через две минуты после выдачи номера.
API-ключ в запросе
GET https://smscash.org/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=8&id=1000000000| Параметр | Тип | Обязательность | Описание | Пример |
|---|---|---|---|---|
| api_key | string | Обязательный | API-ключ. Также можно передать в заголовке X-API-Key или Authorization: Bearer. | APIKEY |
| action | string | Обязательный | Название метода | setStatus |
| status | integer | Обязательный | 3 — повторная SMS, 6 — завершить, 8 — отменить. | 8 |
| id | integer | Обязательный | Идентификатор активации | 1000000000 |
Пример ответа
ACCESS_CANCEL3 — повторный запрос SMS: продлевает ожидание на исходный срок активации и учитывается в лимитах выдачи. При отказе активация не меняется. Не повторяйте автоматически после неопределённого сетевого сбоя.
6 — подтверждение завершения после полученного кода. 8 — отмена; доступна через 2 минуты от начала. Повторные 6 и 8 не создают повторных списаний или начислений.
После кода активация уже завершена. Для новой активации на тот же номер используйте getRepeatNumber.
STATUS_WAIT_CODE — Повторная SMS запрошена, ожидаем код.
ACCESS_ACTIVATION — Активация успешно завершена.
ACCESS_CANCEL — Активация отменена.
Ошибки
BAD_KEY — Неверный, отозванный ключ или запрещённый IP. Проверьте ключ, доступ и IP-адрес сервера.
BANNED — Аккаунт заблокирован. Обратитесь в поддержку.
BAD_ACTION — Неизвестный метод или отсутствующий обязательный параметр. Исправьте action и обязательные параметры.
ERROR_RATE_LIMIT — Превышена частота или число одновременных запросов. Снизьте частоту и учтите Retry-After.
ERROR — Временная ошибка сервера. Примените задержку с увеличением интервала; выдачу повторяйте с тем же Idempotency-Key.
BAD_STATUS — Недопустимый статус. Используйте 3, 6 или 8.
NO_ACTIVATION — Активация не найдена в доступе этого ключа. Проверьте id и ключ, которым получен номер.
NO_NUMBERS — Свободных номеров сейчас нет. Выберите другие условия или повторите позже.
NUMBER_IN_USE — Номер уже занят активацией или удержанием другого клиента. Дождитесь завершения текущей активации.
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.