API weryfikacji SMS

Zakup numeru, sprawdzenie kodu i anulowanie jednym zapytaniem HTTP. To popularny w branży wirtualnych numerów format handler_api, więc wystarczy wpisać adres i klucz w programie do rejestracji lub bocie.

Pobierz klucz API

Po zalogowaniu utwórz klucz w menu API na ekranie konta. Klucz jest pokazywany tylko raz przy tworzeniu, więc od razu go zapisz. API korzysta z tego samego salda i cen co strona www.

Adres bazowy

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

Główne zapytania

actionCzym się zajmujemyPrzykładowa odpowiedź
getBalanceSprawdź saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=krCeny i dostępne numery dla każdej usługi{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krZakup numeruACCESS_NUMBER:ID:PHONE
getStatus&id=IDSprawdź kodSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Anuluj numer (przed kodem, pełny zwrot)ACCESS_CANCEL
setStatus&id=ID&status=3Odbierz kolejny kod na ten sam numerACCESS_RETRY_GET
setStatus&id=ID&status=6ZakończACCESS_ACTIVATION

Parametry zapytania

NazwaWymaganeOpis
api_keyWszystkieKlucz API utworzony na ekranie konta
actionWszystkiegetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberKod usługi (np. telegram, whatsapp, google). Taki sam jak w adresie strony z listą usług
countrygetNumberkr (koreański numer 010, domyślnie kr)
idgetStatus, setStatusID numeru zwrócone przez getNumber (zaczyna się od N-)
statussetStatus8 anuluj, 3 kolejny kod, 6 zakończ, 1 gotowe

Kody odpowiedzi i ich znaczenie

OdpowiedźZnaczeniePieniądze
ACCESS_NUMBER:ID:PHONENumer pobranyCena numeru zostaje pobrana
STATUS_WAIT_CODECzekamy na kodBez zmian
STATUS_OK:CODEKod dotarłPłatność zakończona
STATUS_WAIT_RETRY:CODECzekamy na kolejny kod (wraz z poprzednim)Bez dopłat
STATUS_CANCELAnulowano lub czas minąłZwrócono, jeśli nie było kodu
ACCESS_CANCELAnulowanoPełny zwrot
ACCESS_RETRY_GETCzekaj na kolejny kod na ten sam numerBez dopłat
ACCESS_ACTIVATIONZakończono korzystanie z numeruBez zmian
NO_BALANCEDoładuj saldo i odbieraj od razuBez opłaty
NO_NUMBERSNumer z tego kraju jest teraz niedostępnyBez opłaty
NO_ACTIVATIONSMasz 20 otwartych numerówBez opłaty
EARLY_CANCEL_DENIEDNumer z kodem zakończ (6) zamiast anulowaćBez zmian
BAD_KEYNieprawidłowy klucz APIBez opłaty
BAD_SERVICE / BAD_COUNTRYNieprawidłowy kod usługi lub krajuBez opłaty
NO_ACTIVATIONNie znaleziono ID numeruBez zmian
TOO_MANY_REQUESTSPrzekroczono 300 zapytań na minutęBez opłaty

Przykłady w różnych językach

import time, requests

BASE = "https://010sms.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="kr")
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)

Jak to działa

  • Pobierz numer przez getNumber, wpisz go w formularzu rejestracji i wywołuj getStatus co 5 sekund.
  • STATUS_OK:gdy kod przyjdzie, wpisz go i zakończ przez setStatus 6.
  • Jeśli kod nie dotrze w ciągu 20 minut, cena numeru automatycznie wraca na saldo.
  • Do 300 zapytań na minutę.
API weryfikacji SMS | 010SMS