Выберите язык

Эндпоинт, совместимый с sms-activate

Продолжайте пользоваться ботами и панелями для протокола sms-activate, сменив один URL. Поддерживаемые действия, форматы идентификаторов и важные отличия.

На этой странице
  1. Эндпоинт
  2. Пример
  3. Поддерживаемые действия
  4. Идентификаторы
  5. Важные отличия

Многие инструменты работают по протоколу sms-activate. SmsGrab предлагает совместимый эндпоинт, так что эти инструменты заработают, как только вы смените базовый URL и укажете свой API-ключ SmsGrab.

Эндпоинт

Текст
https://smsgrab.com/api/stubs/handler_api.php

Передавайте api_key и action вместе с параметрами действия методом GET или POST. Ключ можно также передать как Authorization: Bearer.

Пример

Bash
curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"
Текст
ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

Поддерживаемые действия

Действие Что делает
getBalance, getBalanceAndCashBack Ваш баланс
getNumber, getNumberV2 Покупка номера
setStatus 1 готов, 3 ждать ещё одно SMS, 6 завершить, 8 отменить с возвратом
getStatus, getStatusV2 Ожидание, код получен или отменено
getActiveActivations Номера, которые ещё активны
getPrices, getTopCountriesByService, getNumbersStatus Цены и наличие
getCountries, getServicesList Страны и сервисы с их идентификаторами

Идентификаторы

  • Сервисы используют короткие коды протокола, если они есть, например wa WhatsApp, tg Telegram, go Google, fb Facebook, ig Instagram и ds Discord. Наши собственные идентификаторы сервисов тоже работают.
  • Страны используют числовые идентификаторы протокола, если они есть, например 0 Россия, 6 Индонезия, 4 Филиппины, 22 Индия и 187 США. Наши идентификаторы и ISO-коды тоже работают.
  • getCountries и getServicesList возвращают полные актуальные списки.
  • id активации — это число, например 100000123, и REST API его тоже принимает.

Важные отличия

  • Суммы указаны в долларах США с двумя знаками после запятой, по вашей цене для разработчиков. Это не рубли.
  • operator игнорируется; для вас выбирается лучшее доступное предложение.
  • На ошибки мы отвечаем как в исходном протоколе: HTTP 200 и текст вроде NO_NUMBERS, NO_BALANCE или BAD_KEY. На слишком частые запросы приходит HTTP 429 с TOO_MANY_REQUESTS.
  • NO_ACCESS означает, что у ключа нет области purchase, IP-адрес не разрешён или достигнут дневной лимит расходов.
  • Аренда через этот эндпоинт недоступна.

Всё остальное общее с REST API: те же ключи, лимиты, цены, возвраты и вебхуки.

Эта статья была полезной?

Всё ещё нужна помощь?

Напишите нам. Мы отвечаем на каждое сообщение, обычно в течение нескольких часов.

Или напишите на support@smsgrab.com