SMS doğrulama API'si

SNSSIM API, numara satın alma, kod kontrolü, iptal, kredi ve fiyat sorgulamayı tek bir HTTP isteğiyle halleder. Sektör standardı handler_api yöntemini kullanır, mevcut programınıza sadece adres ve API anahtarını değiştirerek bağlanabilirsiniz.

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
Sektör standardı yöntem
handler_api

Sektör standardı yöntem

Her API anahtarı için
Dakikada 300 kez

Her API anahtarı için

Ülke / Hizmet
145 / 1,255

Ülke / Hizmet

İçinde kod yoksa otomatik iade
20 dakika

İçinde kod yoksa otomatik iade

API anahtarı nasıl alınır?

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

Temel adres nedir?

Tüm istekler, api_key ve action eklenerek aynı adrese GET yöntemiyle gönderilir.

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

Hangi istekleri gönderebilirim?

Numara satın almadan kod onaylama, iptal, kredi sorgulama dahil toplam 7 farklı istek mümkündür.

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=8Numara kullanımını iptal etme (kod alınmadığında tam para iadesi)ACCESS_CANCEL
setStatus&id=ID&status=3Aynı numarayla ek doğrulama kodu alACCESS_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 adı kodu (örnek: telegram, whatsapp, google). Hizmet listesi sayfasıyla aynı değerdir
countrygetNumberÜlke kodu 2 karakter (örnek: gb, us, id)
idgetStatus, setStatusgetNumber üzerinden alınan numara ID'si (N ile başlar)
statussetStatus8 iptal, 3 kod tekrar iste, 6 bitir, 1 hazır

Yanıt metni ve anlamı

Yanıtlar kısa metinlerle sağlanır. Kredi kesilip kesilmediği de belirtilir.

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:CODEEk onay kodu 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 kez daha kod alma bekleniyorEk ücret yok
ACCESS_ACTIVATIONNumara kullanımı tamamlandıAynen
NO_BALANCEBakiye yükleyin, hemen alınDüşülmez
NO_NUMBERSŞu anda bu ülkenin numarasını sağlayamıyoruzDüşülmez
NO_ACTIVATIONS20 açık numaranız varDüşülmez
EARLY_CANCEL_DENIEDOnay kodu alınan numaralar için iptal değil sonlandırma (6) seçinAynen
BAD_KEYAPI anahtarı geçersizDüşülmez
BAD_SERVICE / BAD_COUNTRYHizmet veya ülke kodu doğru değilDüşülmez
NO_ACTIVATIONNumara ID'si bulunamadıAynen
TOO_MANY_REQUESTSDakikada 300 istek sınırı aşıldıDüşülmez

API ile kod alma sırası nasıldır?

Numara alıp, girip, kodu onaylayıp tamamlama 4 adımdır.

  1. 1 adım

    Numara al

    getNumber üzerinden istediğiniz hizmet ve ülkeyi seçerek numara alabilirsiniz.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 adım

    Numara gir

    Satın alınan numarayı kayıt sayfasına veya programa girin.

    +44 7700 900123
  3. 3 adım

    Kodu kontrol et

    Kodun gelip gelmediğini kontrol etmek için her 5 saniyede bir getStatus'u çağırın.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 adım

    Bitir

    Kodu girdikten sonra setStatus 6 ile tamamlayın. 20 dakika içinde kod gelmezse otomatik iade yapılır.

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

Dillere göre örnekler

Numara alıp kod bekleyip tamamlama sürecinin tamamı. Sekmeye tıklayarak dili değiştirebilirsiniz.

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 Sık Sorulan Sorular

API, 145 ülke 1,255 servis numarasını web ile aynı fiyattan sunar.

SMS Doğrulama API'si nedir?
Sanal numara alma, doğrulama kodu kontrolü ve iptal işlemlerini HTTP istekleriyle yapmanızı sağlayan özelliktir. SNSSIM API, sektör standardı handler_api yöntemini kullanır.
Diğer SMS doğrulama sitelerinde kullanılan programları aynen kullanabilir miyim?
handler_api yöntemini kullanan bir program kullanıyorsanız, temel adres ve API anahtarını değiştirerek hemen bağlanabilirsiniz.
API için ayrı bir ücret var mı?
Fark yok. API ve web arayüzü aynı kredi ve fiyatları kullanır.
İstek kaç kez yapılabilir?
Her API anahtarı için dakikada maksimum 300 istek yapabilirsiniz. Aşılırsa TOO_MANY_REQUESTS hatası alırsınız ve krediniz düşmez.
API ile alınan numaralar iade edilebilir mi?
Evet. Kod 20 dakika içinde gelmezse API ile satın alınan numara da kredi olarak otomatik iade edilir.
API anahtarı nereden oluşturulur?
Giriş yaptıktan sonra hesap ekranındaki API menüsünden oluşturun. Anahtar yalnızca oluşturulduğunda gösterilir, hemen kaydedin.

API anahtarını oluşturur oluşturmaz bağlanmayı deneyin

Kayıt olduktan sonra kredinizi yükleyerek hesap ekranından hemen bir API anahtarı oluşturabilirsiniz.

SMS doğrulama API'si | SNSSIM