API Pengesahan SMS

Beli nombor dan baca kod SMS dengan permintaan HTTP GET atau POST biasa. Jawapan menggunakan format teks alat pengaktifan SMS biasa, panggilan nombor peribadi menjawab dalam JSON.

Permulaan

Alamat: https://snscodes.com/stubs/handler_api.php
Pengesahan: Parameter api_key. Buat kunci pada halaman API akaun anda; ia hanya dipaparkan sekali.
Had kadar: 300 permintaan seminit setiap kunci
Wang: Harga dan saldo dalam dolar AS, diambil dari saldo yang sama seperti laman 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 akaun anda dalam dolar AS.

Jawapan

ACCESS_BALANCE:42.50

BAD_KEYKunci tiada atau salah.

Harga kod action=getPrices

Harga setiap kod mengikut negara dan perkhidmatan. Kedua-dua penapis adalah pilihan.

Parameter	Diperlukan	Penerangan
service	tidak	Kod perkhidmatan, contohnya telegram
country	tidak	us, gb atau au

Jawapan

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

Beli nombor kod action=getNumber

Membeli satu nombor untuk satu aplikasi. Harga akan ditolak dari saldo anda serta-merta dan dikembalikan jika tiada kod diterima dalam 20 minit.

Parameter	Diperlukan	Penerangan
service	ya	Kod perkhidmatan dari getPrices
country	ya	us, gb atau au

Jawapan

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICEKod perkhidmatan tidak dikenali.
BAD_COUNTRYPerkhidmatan ini tidak dijual untuk negara ini.
NO_BALANCESaldo tidak mencukupi. Tiada caj dikenakan.
NO_NUMBERSTiada nombor tersedia buat masa ini. Tiada caj dikenakan.
NO_ACTIVATIONSAnda sudah mempunyai 20 nombor kod yang aktif.

Baca kod action=getStatus

Periksa setiap 5 hingga 10 saat sehingga kod diterima.

Parameter	Diperlukan	Penerangan
id	ya	ID dari getNumber

Jawapan

STATUS_OK:482913

STATUS_WAIT_CODETiada SMS lagi.
STATUS_WAIT_RETRY:482913Menunggu kod lain; kod terakhir dipaparkan.
STATUS_CANCELDibatalkan atau dikembalikan.
NO_ACTIVATIONID tidak dikenali.

Batal, cuba lagi atau selesai action=setStatus

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

Parameter	Diperlukan	Penerangan
id	ya	ID dari getNumber
status	ya	8, 3 atau 6

Jawapan

ACCESS_CANCEL

EARLY_CANCEL_DENIEDKod sudah diterima; selesaikan daripada membatalkan.
ACCESS_RETRY_GETMenunggu kod lain.
ACCESS_ACTIVATIONSelesai.

Harga nombor peribadi action=getRentPrices

Harga untuk tempoh penuh mengikut negara dan tempoh. Mengembalikan JSON.

Parameter	Diperlukan	Penerangan
country	tidak	Kod negara dua huruf

Jawapan

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

Beli nombor peribadi action=getRentNumber

Membeli nombor peribadi untuk tempoh tertentu. Mengembalikan JSON.

Parameter	Diperlukan	Penerangan
country	ya	Kod negara dua huruf
period	ya	satuBulan, tigaBulan, enamBulan, duaBelasBulan, duaTahun atau tigaTahun

Jawapan

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

BAD_PERIODTempoh ini tidak dijual untuk negara ini.
NO_BALANCESaldo tidak mencukupi.

Baca SMS nombor peribadi action=getRentStatus

Semua SMS yang diterima oleh nombor peribadi setakat ini. Mengembalikan JSON.

Parameter	Diperlukan	Penerangan
id	ya	ID dari getRentNumber

Jawapan

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

Batalkan nombor peribadi action=setRentStatus

status=2 membatalkan nombor peribadi untuk bayaran balik penuh jika tiada SMS diterima dan kurang dari 20 minit.

Parameter	Diperlukan	Penerangan
id	ya	ID dari getRentNumber
status	ya	2

Jawapan

{"status":"success"}

EARLY_CANCEL_DENIEDSMS telah tiba atau 20 minit telah berlalu.