Свернуть содержание

API —  это протокол взаимодействия между вашим ПО и нашим сервером активаций. API нужен для автоматизации процесса получение смс сообщений на вашей стороне

Наше API совместимо с API sms-activate

Во всех запросах должен присутствовать API ключ в виде параметра api_key

image
API активаций
Запрос номера
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&maxPrice=$maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumber
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран»;
$maxPrice — максимальная цена, за которую вы готовы купить номер;
$providerIds - список провайдеров, у которых будет осуществляться закупка, через запятую (1,2,3);
$exceptProviderIds - cписок провайдеров, у которых не будет осуществляться закупка, через запятую (1,2,3).

Возможные ошибки
BAD_KEY — неверный API-ключ;
NO_NUMBERS — нет номеров;
The service is prohibited for sale by administration — выберите другой сервис;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.

Пример успешного ответа:

ACCESS_NUMBER:38496653:66846426435

Где 38496653 — это id активации, а 66846426435 — номер телефона

Протестируйте этот метод сейчас
Ваш API-ключ
Код сервиса
Код страны
API активаций
Запрос номера v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumberV2&service=$service&country=$country&maxPrice=maxPrice&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds

&action=getNumberV2

Метод работает аналогично методу getNumber, принимает те же параметры, но возвращает дополнительную информацию об активации.

$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран»;
$maxPrice — максимальная цена, за которую вы готовы купить номер;
$providerIds - список провайдеров, у которых будет осуществляться закупка, через запятую (1,2,3);
$exceptProviderIds - cписок провайдеров, у которых не будет осуществляться закупка, через запятую (1,2,3).

Возможные ошибки
BAD_KEY — неверный API-ключ;
NO_NUMBERS — нет номеров;
The service is prohibited for sale by administration — выберите другой сервис;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.

Пример успешного ответа:

{
   "activationId": 38496653,
   "phoneNumber": "66846426435",
   "activationCost": 12.34,
   "currency": 840,
   "countryCode": "2",
   "canGetAnotherSms": "1",
   "activationTime": "2025-12-31 23:30:55"
}

Где 38496653 — это id активации, 66846426435 — номер телефона,
12.34 - стоимость активации,
870 - код валюты по ISO 4217, 2 - код страны,
0/1 - поддержка второй SMS (нет/да)
2025-12-31 23:30:55 - дата и время начала активации.

Протестируйте этот метод сейчас
Your API key
Service code
Country code
API активаций
Изменения статуса активации

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

&action=setStatus
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете)
$id — id активации
$status — статус активации
-1 — отменить активацию;
1 — сообщить о готовности номера (смс на номер отправлено);
3 — сообщить об ожидании нового кода на тот же номер;
6 — завершить активацию;
8 — отменить активацию.

Возможные ответы:
ACCESS_READY — готовность номера подтверждена
ACCESS_RETRY_GET — ожидание нового смс
ACCESS_ACTIVATION — сервис успешно активирован
ACCESS_CANCEL — активация отменена

Возможные ошибки:
ERROR_SQL — ошибка SQL-сервера;
NO_ACTIVATION — id активации не существует;
BAD_SERVICE — некорректное наименование сервиса;
BAD_STATUS — некорректный статус;
BAD_KEY — Неверный API-ключ;
BAD_ACTION — некорректное действие;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.

Протестируйте этот метод сейчас
Ваш API-ключ
ID активации
Статус активации
API активаций
Получить код или статус активации

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

&action = getStatus
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете)
$id — id активации

Ответы сервиса:
STATUS_WAIT_CODE — ожидание смс
STATUS_WAIT_RETRY:$lastcode — ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
STATUS_WAIT_RESEND — ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
STATUS_CANCEL — активация отменена
STATUS_OK:$code — код получен (где $code — код активации)

Возможные ошибки:
NO_ACTIVATION — id активации не существует;
BAD_KEY — Неверный API-ключ;
BAD_ACTION — некорректное действие;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.

Протестируйте этот метод сейчас
Ваш API-ключ
ID активации
API активаций
Запрос баланса
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете).

Ответ сервиса

ACCESS_BALANCE:$balance

Возможные ошибки

BAD_KEY — Неверный API-ключ;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.
Протестируйте этот метод сейчас
Ваш API-ключ
API активаций
Получить актуальные цены по странам
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&action=getPrices
$api_key
— ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».

Возможные ошибки

BAD_KEY — Неверный API-ключ;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.

Ответы сервиса в формате

{
  "Страна": {
    "Сервис": {
      "cost": Стоимость,
      "count": Количество
    }
  }
}
Протестируйте этот метод сейчас
Ваш API-ключ
Код сервиса
Код страны
API активаций
Получить актуальные цены v2
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV2&service=$service&country=$country

&action=getPricesV2
$api_key
— ваш API ключ (Настройки);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».

Возможные ошибки

BAD_KEY — неверный API-ключ;
BAD_ACTION — некорректное действие;
BAD_SERVICE — некорректное наименование сервиса.

Ответы сервиса в формате

  "country": {
    "service": {
            "price1": count,
            "price2": count,
            "price3": count,
          }
     },
Протестируйте этот метод сейчас
Your API key
Service code
Country code
API активаций
Получить актуальные цены v3
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPricesV3&service=$service&country=$country

&action=getPricesV3
$api_key
— ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».

Возможные ошибки

BAD_KEY — неверный API-ключ;
BAD_ACTION — некорректное действие;
BAD_SERVICE — некорректное наименование сервиса.

Ответы сервиса в формате

{
  "country": {
    "service": {
      "price": price,
      "count": count,
      "providers": {
        "provider 1 id": {
          "count": count,
          "price": [price1, price2],
          "provider_id": provider_id
        },
        "provider 2 id": {
          "count": count,
          "price": [price],
          "provider_id": provider_id
        },
        "provider 3 id": {
          "count": count,
          "price": [price1, price2, price3],
          "provider_id": provider_id
        }
      }
    }
  }
}
Протестируйте этот метод сейчас
Your API key
Service code
Country code
API-утилиты
Получить статический кошелёк для оплаты
https://api.grizzlysms.com/public/crypto/wallet?api_key=$api_key&coin=usdt&network=tron

$api_key – ваш ключ API (Настройки);
$coin – криптовалюта (usdt);
$network – сеть (trс-20)

Пример ответа:

  {
        "wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
    }

Протестируйте этот метод сейчас
Your API-key