Эндпоинт, совместимый с sms-activate
Продолжайте пользоваться ботами и панелями для протокола sms-activate, сменив один URL. Поддерживаемые действия, форматы идентификаторов и важные отличия.
На этой странице
Многие инструменты работают по протоколу sms-activate. SmsGrab предлагает совместимый эндпоинт, так что эти инструменты заработают, как только вы смените базовый URL и укажете свой API-ключ SmsGrab.
Эндпоинт
https://smsgrab.com/api/stubs/handler_api.php
Передавайте api_key и action вместе с параметрами действия методом GET или POST. Ключ можно также передать как Authorization: Bearer.
Пример
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 |
Страны и сервисы с их идентификаторами |
Идентификаторы
- Сервисы используют короткие коды протокола, если они есть, например
waWhatsApp,tgTelegram,goGoogle,fbFacebook,igInstagram иdsDiscord. Наши собственные идентификаторы сервисов тоже работают. - Страны используют числовые идентификаторы протокола, если они есть, например
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: те же ключи, лимиты, цены, возвраты и вебхуки.
Эта статья была полезной?
Спасибо! Рады, что помогло.