API Xác Minh SMS

Mua số điện thoại và đọc mã SMS bằng các yêu cầu HTTP GET hoặc POST đơn giản. Câu trả lời sử dụng định dạng văn bản của các công cụ kích hoạt SMS phổ biến, các cuộc gọi số điện thoại riêng trả lời bằng JSON.

Bắt đầu

Địa chỉ: https://snscodes.com/stubs/handler_api.php
Xác thực: Tham số api_key. Tạo khóa trên trang API trong tài khoản của bạn; khóa chỉ hiển thị một lần.
Giới hạn tốc độ: 300 yêu cầu mỗi phút cho mỗi khóa
Tiền: Giá cả và số dư tính bằng USD, được trừ từ cùng số dư như trên website.

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

Lấy số dư action=getBalance

Trả về số dư tài khoản của bạn bằng USD.

Câu trả lời

ACCESS_BALANCE:42.50

BAD_KEYKhóa bị thiếu hoặc sai.

Giá mã code action=getPrices

Giá mỗi mã code theo quốc gia và dịch vụ. Cả hai bộ lọc đều tùy chọn.

Tham số	Bắt buộc	Mô tả
service	không	Mã dịch vụ, ví dụ telegram
country	không	us, gb hoặc au

Câu trả lời

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

Mua số code action=getNumber

Mua một số điện thoại cho một ứng dụng. Số tiền sẽ bị trừ ngay từ số dư của bạn và được hoàn lại nếu không nhận được mã trong 20 phút.

Tham số	Bắt buộc	Mô tả
service	có	Mã dịch vụ từ getPrices
country	có	us, gb hoặc au

Câu trả lời

ACCESS_NUMBER:N-7KQ2M9XWD4:14155550123

BAD_SERVICEMã dịch vụ không xác định.
BAD_COUNTRYDịch vụ không được bán cho quốc gia này.
NO_BALANCEKhông đủ số dư. Không có giao dịch nào được thực hiện.
NO_NUMBERSHiện không có số nào khả dụng. Không có giao dịch nào được thực hiện.
NO_ACTIVATIONSBạn đã có 20 số code đang mở.

Đọc mã code action=getStatus

Kiểm tra mỗi 5 đến 10 giây cho đến khi nhận được mã.

Tham số	Bắt buộc	Mô tả
id	có	ID từ getNumber

Câu trả lời

STATUS_OK:482913

STATUS_WAIT_CODEChưa có SMS.
STATUS_WAIT_RETRY:482913Đang chờ mã khác; mã cuối cùng sẽ được hiển thị.
STATUS_CANCELĐã hủy hoặc hoàn tiền.
NO_ACTIVATIONID không xác định.

Hủy, thử lại hoặc hoàn tất action=setStatus

status=8 hủy số không nhận được mã (hoàn tiền đầy đủ), status=3 yêu cầu mã khác trên cùng số, status=6 hoàn tất.

Tham số	Bắt buộc	Mô tả
id	có	ID từ getNumber
status	có	8, 3 hoặc 6

Câu trả lời

ACCESS_CANCEL

EARLY_CANCEL_DENIEDMã đã được gửi đến; hãy hoàn tất thay vì hủy.
ACCESS_RETRY_GETĐang chờ mã khác.
ACCESS_ACTIVATIONĐã hoàn tất.

Giá số riêng action=getRentPrices

Giá cho toàn bộ thời gian thuê theo quốc gia và thời hạn. Trả về JSON.

Tham số	Bắt buộc	Mô tả
country	không	Mã quốc gia 2 chữ cái

Câu trả lời

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

Mua số điện thoại riêng action=getRentNumber

Mua số điện thoại riêng trong một khoảng thời gian. Trả về JSON.

Tham số	Bắt buộc	Mô tả
country	có	Mã quốc gia 2 chữ cái
period	có	oneMonth, threeMonths, sixMonths, twelveMonths, twoYears hoặc threeYears

Câu trả lời

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

BAD_PERIODKhông bán gói thời gian này cho quốc gia.
NO_BALANCEKhông đủ số dư.

Đọc SMS số riêng action=getRentStatus

Tất cả SMS đã nhận được từ số riêng. Trả về JSON.

Tham số	Bắt buộc	Mô tả
id	có	ID từ getRentNumber

Câu trả lời

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

Hủy số riêng action=setRentStatus

status=2 hủy số riêng để hoàn tiền khi chưa nhận SMS và dưới 20 phút.

Tham số	Bắt buộc	Mô tả
id	có	ID từ getRentNumber
status	có	2

Câu trả lời

{"status":"success"}

EARLY_CANCEL_DENIEDĐã nhận SMS hoặc quá 20 phút.