SMS Doğrulama API'si

Düz HTTP GET veya POST istekleri ile numara satın alın ve SMS kodlarını okuyun. Yanıtlar ortak SMS aktivasyon araçlarının metin formatını kullanır, özel numara çağrıları JSON ile yanıt verir.

Başlarken

Adres: https://snscodes.com/stubs/handler_api.php
Kimlik Doğrulama: api_key parametresi. Anahtarı hesabınızın API sayfasında oluşturun; yalnızca bir kez gösterilir.
İstek sınırı: Her anahtar için dakikada 300 istek
Para: Fiyatlar ve bakiye ABD doları cinsinden, web sitesiyle aynı bakiyeden alınır.

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=telegram&country=us"
# ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

curl "https://snscodes.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=N-7KQ2M9XWD4"
# STATUS_OK:482913

import time, requests
BASE = "https://snscodes.com/stubs/handler_api.php"
KEY = "YOUR_KEY"

r = requests.get(BASE, params={"api_key": KEY, "action": "getNumber", "service": "telegram", "country": "us"}).text
_, num_id, phone = r.split(":")
print("number", phone)
while True:
    s = requests.get(BASE, params={"api_key": KEY, "action": "getStatus", "id": num_id}).text
    if s.startswith("STATUS_OK"):
        print("code", s.split(":")[1]); break
    if s == "STATUS_CANCEL":
        break
    time.sleep(5)

const BASE = "https://snscodes.com/stubs/handler_api.php";
const KEY = process.env.SNSCODES_KEY;
const call = async (q) => (await fetch(BASE + "?" + new URLSearchParams({ api_key: KEY, ...q }))).text();

const [, id, phone] = (await call({ action: "getNumber", service: "telegram", country: "us" })).split(":");
console.log("number", phone);
for (;;) {
  const s = await call({ action: "getStatus", id });
  if (s.startsWith("STATUS_OK")) { console.log("code", s.split(":")[1]); break; }
  if (s === "STATUS_CANCEL") break;
  await new Promise((r) => setTimeout(r, 5000));
}

Bakiye al action=getBalance

Hesap bakiyenizi ABD doları cinsinden döndürür.

Cevap

ACCESS_BALANCE:42.50

BAD_KEYAnahtar eksik veya yanlış.

Kod fiyatları action=getPrices

Ülke ve servise göre kod başına fiyatlar. Her iki filtre de isteğe bağlıdır.

Parametre	Gerekli	Açıklama
service	hayır	Servis kodu, örneğin telegram
country	hayır	us, gb veya au

Cevap

{"us":{"telegram":{"cost":3,"count":100}}}

Kod numarası satın al action=getNumber

Bir uygulama için bir numara satın alır. Ücret bakiyenizden hemen alınır ve 20 dakika içinde kod gelmezse iade edilir.

Parametre	Gerekli	Açıklama
service	evet	getPrices'dan servis kodu
country	evet	us, gb veya au

Cevap

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICEBilinmeyen servis kodu.
BAD_COUNTRYBu servis bu ülke için satılmamaktadır.
NO_BALANCEYeterli bakiye yok. Hiçbir ücret alınmaz.
NO_NUMBERSŞu an uygun numara yok. Hiçbir ücret alınmaz.
NO_ACTIVATIONSZaten 20 açık kod numaranız var.

Kodu oku action=getStatus

Kod gelene kadar her 5 ila 10 saniyede bir kontrol edin.

Parametre	Gerekli	Açıklama
id	evet	getNumber'dan id

Cevap

STATUS_OK:482913

STATUS_WAIT_CODEHenüz SMS yok.
STATUS_WAIT_RETRY:482913Başka bir kod bekleniyor; son gönderilen kod gösterilir.
STATUS_CANCELİptal edildi veya iade edildi.
NO_ACTIVATIONBilinmeyen id.

İptal, tekrar dene veya bitir action=setStatus

status=8 kodsuz bir numarayı iptal eder (tam iade), status=3 aynı numaraya başka bir kod ister, status=6 bitirir.

Parametre	Gerekli	Açıklama
id	evet	getNumber'dan id
status	evet	8, 3 veya 6

Cevap

ACCESS_CANCEL

EARLY_CANCEL_DENIEDZaten bir kod geldi; iptal yerine bitir.
ACCESS_RETRY_GETBaşka bir kod bekleniyor.
ACCESS_ACTIVATIONTamamlandı.

Özel numara fiyatları action=getRentPrices

Ülke ve döneme göre tüm dönem için fiyat. JSON döndürür.

Parametre	Gerekli	Açıklama
country	hayır	İki harfli ülke kodu

Cevap

{"us":{"sixMonths":35.99,"twelveMonths":59.99}}

Özel numara satın al action=getRentNumber

Belirli bir süre için özel numara satın alır. JSON döndürür.

Parametre	Gerekli	Açıklama
country	evet	İki harfli ülke kodu
period	evet	oneMonth, threeMonths, sixMonths, twelveMonths, twoYears veya threeYears

Cevap

{"status":"success","id":"N-3HV8QZ2K5M","phone":"14155550123","until":"2027-05-02T10:00:00.000Z"}

BAD_PERIODBu ülke için bu süre satılmamaktadır.
NO_BALANCEYeterli bakiye yok.

Özel numara SMS'lerini oku action=getRentStatus

Özel numaraya şu ana kadar gelen tüm SMS'ler. JSON döndürür.

Parametre	Gerekli	Açıklama
id	evet	getRentNumber'dan alınan id

Cevap

{"status":"success","state":"active","messages":[{"code":"482913","text":"Your code is 482913","from":"Telegram","at":"..."}]}

Özel numarayı iptal et action=setRentStatus

status=2, henüz SMS gelmediyse ve 20 dakikadan daha eski değilse özel numarayı tam iade ile iptal eder.

Parametre	Gerekli	Açıklama
id	evet	getRentNumber'dan alınan id
status	evet	2

Cevap

{"status":"success"}

EARLY_CANCEL_DENIEDBir SMS geldi veya 20 dakika geçti.