API для SMS-верификации

API SNSSIM обрабатывает покупку номеров, проверку кодов, отмену, проверку баланса и цен одним HTTP-запросом. Использует стандартный handler_api - просто замените адрес и API-ключ в вашей программе.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Отраслевой стандарт
handler_api

Отраслевой стандарт

Для каждого API ключа
300 раз в минуту

Для каждого API ключа

Страна / Сервис
145 / 1,255

Страна / Сервис

Автоматический возврат, если код не пришел
20 минут

Автоматический возврат, если код не пришел

Как получить API ключ?

Создайте ключ API в меню API в аккаунте после входа. Ключ показывается только один раз - сохраните его сразу. API использует тот же кредит и цены, что и веб-интерфейс.

Что такое базовый адрес?

Все запросы отправляются GET-методом на один адрес с добавлением api_key и action.

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

Какие запросы можно отправлять?

Доступно 7 типов запросов: от покупки номера до проверки кода, отмены и проверки баланса.

actionЧто мы делаемПример ответа
getBalanceПроверка балансаACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbЦены и доступные номера по сервисам и странам{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbПокупка номераACCESS_NUMBER:ID:PHONE
getStatus&id=IDПроверить кодSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Отмена номера (полный возврат средств, если код не получен)ACCESS_CANCEL
setStatus&id=ID&status=3Получить дополнительный код на тот же номерACCESS_RETRY_GET
setStatus&id=ID&status=6ЗавершитьACCESS_ACTIVATION

Параметры запроса

ИмяОбязательноОписание
api_keyВсеAPI-ключ, созданный на странице аккаунта
actionВсеgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberКод сервиса (например: telegram, whatsapp, google). Значения совпадают со списком на странице сервисов.
countrygetNumber2-буквенный код страны (например: gb, us, id)
idgetStatus, setStatusID номера, выданного через getNumber (начинается с N)
statussetStatus8 - отмена, 3 - запрос кода повторно, 6 - завершение, 1 - готово

Ответы и их значение

Ответы краткие и текстовые. Также указывается, списан ли баланс.

ОтветЗначениеДеньги
ACCESS_NUMBER:ID:PHONEНомер полученСтоимость номера списывается
STATUS_WAIT_CODEОжидаем кодБез изменений
STATUS_OK:CODEКод полученОплата завершена
STATUS_WAIT_RETRY:CODEОжидаю дополнительный код аутентификации (включая предыдущий код)Без доплаты
STATUS_CANCELОтменено или время истеклоВозвращено, если кода не было
ACCESS_CANCELОтмененоПолный возврат
ACCESS_RETRY_GETОжидание повторного получения кода на тот же номерБез доплаты
ACCESS_ACTIVATIONРабота с номером завершенаБез изменений
NO_BALANCEПополните баланс и получайте сразуНе списывается
NO_NUMBERSВ настоящее время мы не можем предоставить номер для этой страныНе списывается
NO_ACTIVATIONSОткрыто 20 номеровНе списывается
EARLY_CANCEL_DENIEDДля номеров, получивших код, выберите завершение (6), а не отмену.Без изменений
BAD_KEYНеверный API-ключНе списывается
BAD_SERVICE / BAD_COUNTRYНеверный код сервиса или страныНе списывается
NO_ACTIVATIONID номера не найденБез изменений
TOO_MANY_REQUESTSПревышен лимит 300 запросов в минутуНе списывается

Как получить код через API?

4 шага: получение номера, ввод, проверка кода и завершение.

  1. 1 шагов

    Получить номер

    Используйте getNumber, чтобы выбрать сервис и страну для получения номера.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 шагов

    Вставить номер

    Введите купленный номер на странице регистрации или в программе.

    +44 7700 900123
  3. 3 шагов

    Проверить код

    Проверяйте статус кода через getStatus каждые 5 секунд.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 шагов

    Завершить

    После ввода кода завершите процесс с setStatus 6. Если код не получен в течение 20 минут, средства автоматически возвращаются.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Примеры на разных языках

Полный процесс: получение номера, ожидание кода и завершение. Нажмите на вкладку, чтобы изменить язык.

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Часто задаваемые вопросы по API

API предоставляет номера 1,255 сервисов в 145 странах по тем же ценам, что и сайт.

Что такое API для SMS-подтверждения?
Функция для покупки виртуальных номеров, проверки кодов подтверждения и отмены через HTTP-запросы. SNSSIM API использует стандартный метод handler_api.
Можно ли использовать программы, которые я использовал на других сайтах SMS-верификации?
Если ваша программа поддерживает handler_api, просто измените базовый адрес и API-ключ для подключения.
Есть ли отдельная плата за API?
Нет разницы. API и веб-интерфейс используют один и тот же кредит и цены.
Сколько запросов можно сделать?
До 300 запросов в минуту на один API-ключ. При превышении - ошибка TOO_MANY_REQUESTS без списания средств.
Возвращаются ли номера, купленные через API?
Да. Если код не придет в течение 20 минут, номер, купленный через API, также автоматически вернется на баланс.
Где создать API ключ?
Создайте ключ в меню API в аккаунте после входа. Ключ показывается только один раз при создании - сохраните его сразу.

Создайте API-ключ и подключитесь сразу

После регистрации пополните баланс, и вы сможете сразу создать API-ключ в интерфейсе аккаунта.

API для SMS-верификации | SNSSIM