API Verifikasi SMS

Beli nomor dan baca kode SMS dengan permintaan HTTP GET atau POST sederhana. Jawaban menggunakan format teks dari alat aktivasi SMS umum, panggilan nomor pribadi menjawab dalam JSON.

Memulai

Alamat: https://snscodes.com/stubs/handler_api.php
Autentikasi: Parameter api_key. Buat kunci di halaman API akun Anda; hanya ditampilkan sekali.
Batas permintaan: 300 permintaan per menit per kunci
Uang: Harga dan saldo dalam dolar AS, diambil dari saldo yang sama dengan situs web.

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));
}

Dapatkan saldo action=getBalance

Mengembalikan saldo akun Anda dalam dolar AS.

Jawaban

ACCESS_BALANCE:42.50

BAD_KEYKunci tidak ada atau salah.

Harga kode action=getPrices

Harga per kode berdasarkan negara dan layanan. Kedua filter bersifat opsional.

Parameter	Wajib	Deskripsi
service	tidak	Kode layanan, contohnya telegram
country	tidak	us, gb, atau au

Jawaban

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

Beli nomor kode action=getNumber

Membeli satu nomor untuk satu aplikasi. Harga akan langsung dipotong dari saldo Anda dan dikembalikan jika tidak ada kode yang diterima dalam 20 menit.

Parameter	Wajib	Deskripsi
service	ya	Kode layanan dari getPrices
country	ya	us, gb, atau au

Jawaban

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICEKode layanan tidak dikenal.
BAD_COUNTRYLayanan tidak tersedia untuk negara ini.
NO_BALANCESaldo tidak cukup. Tidak ada yang dikenakan biaya.
NO_NUMBERSTidak ada nomor yang tersedia saat ini. Tidak ada yang dikenakan biaya.
NO_ACTIVATIONSAnda sudah memiliki 20 nomor kode yang aktif.

Baca kode action=getStatus

Periksa setiap 5 hingga 10 detik sampai kode diterima.

Parameter	Wajib	Deskripsi
id	ya	ID dari getNumber

Jawaban

STATUS_OK:482913

STATUS_WAIT_CODEBelum ada SMS.
STATUS_WAIT_RETRY:482913Menunggu kode lain; kode terakhir ditampilkan.
STATUS_CANCELDibatalkan atau dikembalikan.
NO_ACTIVATIONID tidak dikenal.

Batalkan, ulangi, atau selesaikan action=setStatus

status=8 membatalkan nomor tanpa kode (pengembalian penuh), status=3 meminta kode lain pada nomor yang sama, status=6 menyelesaikannya.

Parameter	Wajib	Deskripsi
id	ya	ID dari getNumber
status	ya	8, 3, atau 6

Jawaban

ACCESS_CANCEL

EARLY_CANCEL_DENIEDKode sudah diterima; selesaikan alih-alih membatalkan.
ACCESS_RETRY_GETMenunggu kode lain.
ACCESS_ACTIVATIONSelesai.

Harga nomor pribadi action=getRentPrices

Harga untuk seluruh periode berdasarkan negara dan periode. Mengembalikan JSON.

Parameter	Wajib	Deskripsi
country	tidak	Kode negara dua huruf

Jawaban

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

Beli nomor pribadi action=getRentNumber

Membeli nomor pribadi untuk periode tertentu. Mengembalikan JSON.

Parameter	Wajib	Deskripsi
country	ya	Kode negara dua huruf
period	ya	oneMonth, threeMonths, sixMonths, twelveMonths, twoYears atau threeYears

Jawaban

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

BAD_PERIODPeriode tidak dijual untuk negara ini.
NO_BALANCESaldo tidak cukup.

Baca SMS nomor pribadi action=getRentStatus

Semua SMS yang diterima oleh nomor pribadi sejauh ini. Mengembalikan JSON.

Parameter	Wajib	Deskripsi
id	ya	ID dari getRentNumber

Jawaban

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

Batalkan nomor pribadi action=setRentStatus

status=2 membatalkan nomor pribadi untuk pengembalian dana penuh selama tidak ada SMS yang datang dan kurang dari 20 menit.

Parameter	Wajib	Deskripsi
id	ya	ID dari getRentNumber
status	ya	2

Jawaban

{"status":"success"}

EARLY_CANCEL_DENIEDSMS telah datang atau 20 menit telah berlalu.