Виберіть мову

Ендпоінт, сумісний з 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