Giriş yap

SMS doğrulama API'si

Numara satın alma, kod kontrolü ve iptal işlemlerini tek bir HTTP isteğiyle yapın. Sanal numara sektöründe yaygın kullanılan handler_api tarzında olduğu için kayıt programlarına ve botlara yalnızca adresi ve anahtarı girerek hemen bağlanırsınız.

API anahtarı al

Giriş yaptıktan sonra hesap ekranındaki API menüsünden bir anahtar oluşturun. Anahtar yalnızca oluşturulduğunda bir kez gösterilir, hemen kaydedin. API, web arayüzüyle aynı bakiyeyi ve aynı fiyatları kullanır.

Temel adres

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

Başlıca istekler

actionNe yapıyoruzÖrnek yanıt
getBalanceBakiyeyi kontrol etACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbHizmet ve ülkelere göre fiyatlar ve kalan numaralar{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbNumara satın alACCESS_NUMBER:ID:PHONE
getStatus&id=IDKodu kontrol etSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Numarayı iptal et (kod gelmeden önce, tam iade)ACCESS_CANCEL
setStatus&id=ID&status=3Aynı numarayla bir kod daha alınACCESS_RETRY_GET
setStatus&id=ID&status=6Kullanımı bitirACCESS_ACTIVATION

İstek parametresi

AdZorunluAçıklama
api_keyTümüHesap ekranında oluşturulan API anahtarı
actionTümügetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberHizmet kodu (örn. telegram, whatsapp, google). Hizmet listesi sayfasının adresiyle aynıdır
countrygetNumberİki harfli ülke kodu (örn. gb, us, id)
idgetStatus, setStatusgetNumber'ın döndürdüğü numara ID'si (N- ile başlar)
statussetStatus8 iptal, 3 bir kod daha, 6 bitir, 1 hazır

Yanıt metni ve anlamı

YanıtAnlamıPara
ACCESS_NUMBER:ID:PHONENumaranız hazırNumara ücreti düşülür
STATUS_WAIT_CODEKod bekleniyorAynen
STATUS_OK:CODEKod geldiÖdeme tamamlandı
STATUS_WAIT_RETRY:CODESonraki kod bekleniyor (önceki kodlar dahil)Ek ücret yok
STATUS_CANCELİptal edildi veya süresi dolduKod gelmediyse iade edildi
ACCESS_CANCELİptal edildiTam iade
ACCESS_RETRY_GETAynı numarayla bir kod daha bekleniyorEk ücret yok
ACCESS_ACTIVATIONNumara kullanımı tamamlandıAynen
NO_BALANCEBakiye yükleyin, hemen alınDüşülmez
NO_NUMBERSŞu anda bu ülkenin numarası verilemiyorDüşülmez
NO_ACTIVATIONS20 açık numaranız varDüşülmez
EARLY_CANCEL_DENIEDKod alınan numaralarda iptal yerine bitir (6)Aynen
BAD_KEYAPI anahtarı geçersizDüşülmez
BAD_SERVICE / BAD_COUNTRYHizmet veya ülke kodu geçersizDüşülmez
NO_ACTIVATIONNumara ID'si bulunamadıAynen
TOO_MANY_REQUESTSDakikada 300 istek sınırı aşıldıDüşülmez

Dillere göre örnekler

import time, requests

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

Nasıl kullanılır

  • getNumber ile numara alın, numarayı kayıt ekranına girin, ardından getStatus'u 5 saniye arayla çağırın.
  • STATUS_OK:kod geldiğinde o kodu girin ve setStatus 6 ile bitirin.
  • 20 dakika içinde kod gelmezse numara ücreti bakiyenize otomatik iade edilir.
  • Dakikada 300 isteğe kadar gönderebilirsiniz.