SMS Doğrulama API

Numara alımı, kod kontrolü ve iptali tek bir HTTP isteğiyle yapılır. Sanal numara sektöründe yaygın olarak kullanılan handler_api yapısı sayesinde 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 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://010sms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Temel istekler

actionYaptıklarımızYanıt örneği
getBalanceBakiyeyi kontrol etACCESS_BALANCE:12.50
getPrices&service=telegram&country=krServislere göre fiyat ve kalan numaralar{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krNumara 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ı numaraya bir kod daha alACCESS_RETRY_GET
setStatus&id=ID&status=6Kullanımı bitirACCESS_ACTIVATION

İstek alanı

AdZorunluAçıklama
api_keyTümüHesap ekranında oluşturulan API anahtarı
actionTümügetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberServis kodu (ör. telegram, whatsapp, google). Servis listesi sayfasının adresiyle aynıdır
countrygetNumberkr (Kore 010 numarası, boş bırakılırsa da kr)
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:PHONENumara alındıNumara bedeli düşülür
STATUS_WAIT_CODEKod bekleniyorOlduğu gibi
STATUS_OK:CODEKod geldiÖdeme tamamlandı
STATUS_WAIT_RETRY:CODESonraki kod bekleniyor (önceki kodla birlikte)Ek ücret yok
STATUS_CANCELİptal edildi veya süre dolduKod gelmediyse iade edildi
ACCESS_CANCELİptal edildiTam iade
ACCESS_RETRY_GETAynı numarada bir kod daha bekleniyorEk ücret yok
ACCESS_ACTIVATIONNumara kullanımı bitirildiOlduğu gibi
NO_BALANCEBakiye yükleyince hemen alırsınızDüşülmez
NO_NUMBERSŞu anda bu ülkenin numarası verilemiyorDüşülmez
NO_ACTIVATIONS20 açık numaranız varDüşülmez
EARLY_CANCEL_DENIEDKod alınan numarada iptal yerine bitir (6)Olduğu gibi
BAD_KEYAPI anahtarı geçersizDüşülmez
BAD_SERVICE / BAD_COUNTRYServis veya ülke kodu geçersizDüşülmez
NO_ACTIVATIONNumara ID'si bulunamadıOlduğu gibi
TOO_MANY_REQUESTSDakikada 300 istek sınırı aşıldıDüşülmez

Dillere göre örnekler

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)

Şöyle kullanın

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