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 ключа

Country / Service
145 / 1,255

Country / Service

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

Автоматичний повернення коштів, якщо код відсутній

Як отримати 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 номеру (починається з N), отриманого через getNumber
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 кроків

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

    Перевіряйте статус отримання коду кожні 5 секунд за допомогою getStatus.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 кроків

    Finish

    Після введення коду завершіть процес, встановивши 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