API weryfikacji SMS

API SNSSIM obsługuje zakup numeru, sprawdzanie kodu, anulowanie, sprawdzanie salda i cen w jednym żądaniu HTTP. Zgodne ze standardem handler_api - wystarczy zmienić adres i klucz API w istniejącym programie.

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
Standard branżowy
handler_api

Standard branżowy

Dla każdego klucza API
300 razy na minutę

Dla każdego klucza API

Kraj / Usługa
145 / 1,255

Kraj / Usługa

Automatyczny zwrot, jeśli kod nie przyjdzie
20 minut

Automatyczny zwrot, jeśli kod nie przyjdzie

Jak otrzymać klucz API?

Po zalogowaniu utwórz klucz w menu API na stronie konta. Klucz jest wyświetlany tylko raz podczas tworzenia, więc zapisz go natychmiast. API używa tego samego salda i cen co interfejs webowy.

Jaki jest podstawowy adres?

Wszystkie żądania są wysyłane metodą GET na ten sam adres z dodatkiem api_key i action.

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

Jakie żądania mogę wysyłać?

Możliwe są łącznie 7 żądań, od zakupu numeru po sprawdzanie kodu, anulowanie i sprawdzanie salda.

actionZadaniePrzykład odpowiedzi
getBalanceSprawdź saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbCeny i dostępne numery według usług i krajów{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbZakup numeruACCESS_NUMBER:ID:PHONE
getStatus&id=IDSprawdź kodSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Anulowanie użycia numeru (pełny zwrot w przypadku nieotrzymania kodu)ACCESS_CANCEL
setStatus&id=ID&status=3Otrzymaj dodatkowy kod weryfikacyjny na ten sam numerACCESS_RETRY_GET
setStatus&id=ID&status=6ZakończACCESS_ACTIVATION

Pola zapytania

NazwaWymaganeOpis
api_keyWszystkieKlucz API utworzony na ekranie konta
actionWszystkiegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberKod nazwy usługi (np. telegram, whatsapp, google). Ta sama wartość co na stronie listy usług
countrygetNumberKod kraju 2-znakowy (np. gb, us, id)
idgetStatus, setStatusID numeru z getNumber (zaczyna się od N)
statussetStatus8 - Anuluj, 3 - Wyślij kod ponownie, 6 - Zakończ, 1 - Gotowy

Treść odpowiedzi i znaczenie

Odpowiedzi są dostarczane w postaci krótkich komunikatów. Pokazane jest również, czy kredyt został odjęty.

OdpowiedźZnaczeniePieniądze
ACCESS_NUMBER:ID:PHONENumer otrzymanyCena numeru zostaje pobrana
STATUS_WAIT_CODECzekamy na kodBez zmian
STATUS_OK:CODEKod dotarłPłatność zakończona
STATUS_WAIT_RETRY:CODECzekam na dodatkowy kod weryfikacyjny (w tym poprzedni kod)Bez dodatkowych opłat
STATUS_CANCELAnulowano lub czas minąłZwrócono, jeśli nie było kodu
ACCESS_CANCELAnulowanoPełny zwrot
ACCESS_RETRY_GETOczekiwanie na ponowne otrzymanie kodu na ten sam numerBez dodatkowych opłat
ACCESS_ACTIVATIONZakończyłeś korzystanie z numeruBez zmian
NO_BALANCEDoładuj saldo i odbieraj od razuBez potrącenia
NO_NUMBERSObecnie nie oferujemy numerów z tego kraju.Bez potrącenia
NO_ACTIVATIONSMasz 20 otwartych numerówBez potrącenia
EARLY_CANCEL_DENIEDWybierz zakończenie (6) dla numeru, który otrzymał kod weryfikacyjny, a nie anulowanieBez zmian
BAD_KEYNieprawidłowy klucz APIBez potrącenia
BAD_SERVICE / BAD_COUNTRYKod usługi lub kraju jest nieprawidłowyBez potrącenia
NO_ACTIVATIONNie znaleziono ID numeruBez zmian
TOO_MANY_REQUESTSPrzekroczono 300 zapytań na minutęBez potrącenia

Jak wygląda kolejność odbierania kodów przez API?

4 kroki: otrzymanie numeru, wprowadzenie go, sprawdzenie kodu i zakończenie.

  1. 1 kroków

    Odbierz numer

    Wybierz usługę i kraj w getNumber, aby otrzymać numer.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 kroków

    Wprowadź numer

    Wprowadź zakupiony numer na stronie rejestracji lub w programie.

    +44 7700 900123
  3. 3 kroków

    Sprawdź kod

    Sprawdzaj status co 5 sekund przez getStatus.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 kroków

    Zakończ

    Po wprowadzeniu kodu zakończ ustawiając setStatus 6. Jeśli kod nie zostanie otrzymany w ciągu 20 minut, nastąpi automatyczny zwrot.

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

Przykłady w różnych językach

Pełny proces od otrzymania numeru, przez oczekiwanie na kod, do zakończenia. Kliknij kartę, aby zmienić język.

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)

Najczęstsze pytania dotyczące API

API oferuje numery z 1,255 usług w 145 krajach w takich samych cenach jak strona.

Co to jest API do weryfikacji SMS?
Funkcja umożliwiająca zakup numerów wirtualnych, weryfikację kodów i anulowanie za pomocą żądań HTTP w programie. SNSSIM API używa standardowej metody handler_api.
Czy mogę używać programu, którego używałem na innych stronach do weryfikacji SMS?
Programy używające handler_api mogą się połączyć od razu, zmieniając tylko podstawowy adres i klucz API.
Czy API jest dodatkowo płatne?
Nie ma różnicy. API i interfejs webowy używają tego samego kredytu i cen.
Ile razy można składać żądanie?
Limit: 300 żądań na minutę na klucz API. Przekroczenie = błąd TOO_MANY_REQUESTS, bez straty środków.
Czy numery zakupione przez API podlegają zwrotowi?
Tak. Jeśli kod nie dotrze w ciągu 20 minut, numer zakupiony przez API zostanie automatycznie zwrócony jako kredyt.
Gdzie można utworzyć klucz API?
Po zalogowaniu utwórz klucz w menu API na stronie konta. Klucz jest wyświetlany tylko raz podczas tworzenia, więc zapisz go natychmiast.

Po utworzeniu klucza API od razu się połącz

Po rejestracji i doładowaniu salda możesz od razu wygenerować klucz API w panelu konta.

API weryfikacji SMS | SNSSIM