API Xác minh SMS — SMSNoKYC

Tự động hóa xác minh OTP từ đầu đến cuối. Giữ số ảo ở hơn 190 quốc gia, đọc mã SMS trong vài giây, thuê các tuyến riêng dài hạn và điều khiển mọi đơn hàng qua một bề mặt REST duy nhất — không khóa API, không KYC, trả bằng tiền mã hóa.

Thời gian đọc: 5 phút REST · JSON · OpenAPI 3.0 Cập nhật lần cuối: 2026-07-04 Đặc tả OpenAPI →

Tại sao các lập trình viên chọn API SMSNoKYC

SMSNoKYC là API xác minh SMS linh hoạt nhất dành cho các lập trình viên cần ẩn danh, phủ sóng toàn cầu và giá cả minh bạch. Khác với các nhà cung cấp SMS-OTP truyền thống đòi hỏi hợp đồng doanh nghiệp, mức tối thiểu hàng tháng và bảng câu hỏi KYC, SMSNoKYC hoạt động với bất kỳ HTTPS client nào, tính phí theo từng số, và chấp nhận 20+ loại tiền mã hóa bao gồm Bitcoin, Monero, Ethereum, USDT, USDC, Solana, Litecoin, XRP, TRON và Toncoin.

Các trường hợp sử dụng điển hình bao gồm tự động hóa đăng ký tài khoản cho QA quy mô lớn, lấy mật khẩu một lần cho các headless agent và CI bot, xác thực luồng yêu cầu số điện thoại trong continuous integration, thuê số dài hạn cho tài khoản Telegram hoặc WhatsApp cần nhận SMS liên tục, và xác minh phân tán địa lý tại 190+ quốc gia với kiểm soát cấp nhà mạng — ảo, vật lý hoặc premium.

Xác Thực

API sử dụng xác thực phiên dựa trên cookie. Để xác thực theo cách lập trình:

Gửi yêu cầu POST đến /auth-api.php kèm theo seed phrase của bạn
Lưu cookie phiên từ phản hồi
Đính kèm cookie trong tất cả các yêu cầu API tiếp theo

POST /auth-api.php

Xác thực bằng cụm từ seed của bạn và thiết lập phiên.

Tham số	Loại	Bắt buộc	Mô tả
action	string	bắt buộc	Phải là `"login"`
seed	string	bắt buộc	Seed truy cập 16 ký tự của bạn (ví dụ: `AbC3-dEf4-gHj5-kLm6`)

cURL
Python
JavaScript
# Login and save session cookie
curl -X POST https://smsnokyc.com/auth-api.php \
  -d "action=login&seed=AbC3-dEf4-gHj5-kLm6" \
  -c cookies.txt
import requests

session = requests.Session()
resp = session.post("https://smsnokyc.com/auth-api.php", data={
    "action": "login",
    "seed": "AbC3-dEf4-gHj5-kLm6"
})
data = resp.json()
print(data)  # {"success": true, "user": {...}}

# session object now holds the cookie for all future requests
const resp = await fetch("https://smsnokyc.com/auth-api.php", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: "action=login&seed=AbC3-dEf4-gHj5-kLm6"
});
const data = await resp.json();
console.log(data); // {success: true, user: {...}}

Phản Hồi Thành Công

{ "success": true, "user": { "id": 42, "prefix": "AbC3", "balance": "74.50" } }

Phản hồi lỗi

{ "success": false, "error": "Invalid seed." }

URL Cơ Sở

Tất cả các endpoint API đều tương đối với:

https://smsnokyc.com/api.php?action={action}

Tất cả phản hồi đều ở định dạng JSON. Các endpoint POST chấp nhận cả hai kiểu nội dung yêu cầu application/json và application/x-www-form-urlencoded.

Giới hạn tần suất

API áp dụng các giới hạn tần suất sau:

Endpoint	Giới hạn	Cửa sổ
Xác Thực	5 lần thử	15 phút
Tất cả các endpoint khác	Không giới hạn cứng	—

Giới hạn tốc độ: Xác thực bị giới hạn ở 5 lần thử mỗi 15 phút. Các endpoint khác hiện chưa bị giới hạn, nhưng việc sử dụng quá mức có thể bị hạn chế. Hãy sử dụng khoảng thời gian yêu cầu hợp lý.

Xử lý lỗi

Tất cả lỗi trả về một đối tượng JSON với trường <code>error</code>:

{ "error": "Description of what went wrong" }

Mã HTTP	Ý nghĩa
200	Thành công (kiểm tra nội dung phản hồi để phát hiện lỗi cấp ứng dụng)
403	Token CSRF không hợp lệ
405	Phương thức HTTP sai (ví dụ: GET trên endpoint chỉ nhận POST)
429	Đã vượt giới hạn tần suất

Các lỗi phổ biến ở cấp ứng dụng:

Lỗi	Nguyên Nhân
`"Login required"`	Phiên đã hết hạn hoặc chưa xác thực
`"Insufficient balance"`	Số dư không đủ — bao gồm các trường `need` và `have`
`"Service not available for this country"`	Không có hàng hoặc dịch vụ không hoạt động cho quốc gia đã chọn
`"Missing country or service"`	Chưa cung cấp các tham số bắt buộc

Danh sách quốc gia

GET /api.php?action=countries

Trả về tất cả quốc gia đang hoạt động có số ảo khả dụng. Không yêu cầu xác thực.

cURL
Python
JavaScript
curl https://smsnokyc.com/api.php?action=countries
resp = session.get("https://smsnokyc.com/api.php", params={"action": "countries"})
countries = resp.json()
for c in countries:
    print(c["code"], c["name"])
const resp = await fetch("https://smsnokyc.com/api.php?action=countries");
const countries = await resp.json();

Phản hồi

[ { "id": 1, "code": "us", "name": "USA" }, { "id": 2, "code": "gb", "name": "UK" }, { "id": 3, "code": "de", "name": "Germany" } ]

Danh sách dịch vụ

GET /api.php?action=services&country={code}

Trả về các dịch vụ khả dụng cho một quốc gia cụ thể, bao gồm giá và số lượng tồn kho. Nếu không có mã quốc gia, trả về tất cả dịch vụ mà không có thông tin giá.

Tham số	Loại	Bắt buộc	Mô tả
country	string	tùy chọn	Mã quốc gia ISO 3166-1 alpha-2 (ví dụ: `us`, `gb`, `de`)

Phản hồi (kèm quốc gia)

[ { "id": 12, "name": "WhatsApp", "slug": "whatsapp", "icon_code": "WA", "icon_color": "#25d366", "category": "social", "price": "0.35", "stock": 847 } ]

Danh sách nhà mạng

GET /api.php?action=operators&country={code}

Trả về các nhà mạng khả dụng cho một quốc gia cụ thể. Mỗi nhà mạng có một loại và hệ số nhân giá áp dụng vào giá dịch vụ cơ bản.

Tham số	Loại	Bắt buộc	Mô tả
country	string	bắt buộc	Mã quốc gia ISO 3166-1 alpha-2

Phản hồi

[ { "id": 5, "name": "T-Mobile", "type": "physical", "price_multiplier": "1.50", "icon_slug": "tmobile", "icon_domain": "t-mobile.com" } ]

Loại nhà mạng: virtual — Số VoIP, rẻ nhất, có thể bị một số dịch vụ chặn. physical — SIM thực, tỷ lệ thành công cao hơn. premium — giao tin nhắn nhanh nhất (~10 giây), tỷ lệ thành công cao nhất.

Mua Số (Kích Hoạt SMS)

POST /api.php?action=buy

Mua một số ảo để xác minh SMS một lần. Số có hiệu lực trong 20 phút. Nếu không nhận được SMS, số dư của bạn sẽ được tự động hoàn trả.

Tham số	Loại	Bắt buộc	Mô tả
country	string	bắt buộc	Mã quốc gia (ví dụ: `us`)
service_id	integer	bắt buộc	ID dịch vụ từ Danh Sách Dịch Vụ
operator_id	integer	tùy chọn	ID nhà mạng từ Danh sách nhà mạng. Bỏ trống để dùng nhà mạng mặc định.

cURL
Python
JavaScript
curl -X POST https://smsnokyc.com/api.php?action=buy \
  -b cookies.txt \
  -H "Content-Type: application/json" \
  -d '{"country":"us","service_id":12,"operator_id":5}'
resp = session.post("https://smsnokyc.com/api.php?action=buy", json={
    "country": "us",
    "service_id": 12,
    "operator_id": 5
})
order = resp.json()
print(f"Order #{order['order_id']} — ${order['price']}")
const resp = await fetch("https://smsnokyc.com/api.php?action=buy", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ country: "us", service_id: 12, operator_id: 5 })
});
const order = await resp.json();

Phản Hồi Thành Công

{ "success": true, "order_id": 1847, "price": 0.53, "balance": "73.97" }

Lỗi: Số dư không đủ

{ "error": "Insufficient balance", "need": 0.53, "have": "0.10" }

Danh sách đơn hàng

GET /api.php?action=orders

Trả về 50 đơn hàng gần nhất của bạn, bao gồm số điện thoại và mã SMS. Gọi định kỳ endpoint này để kiểm tra mã SMS đến trên các đơn hàng đang hoạt động.

Phản hồi

[ { "id": 1847, "price": "0.53", "status": "completed", "phone_number": "+12025551234", "sms_code": "847293", "created_at": "2026-04-09 14:32:00", "country_code": "us", "country_name": "USA", "service_name": "WhatsApp", "operator_name": "T-Mobile" } ]

Trạng thái đơn hàng: active — đang chờ SMS. completed — đã nhận SMS. cancelled — người dùng đã hủy. refunded — đã hoàn tiền tự động (không nhận được SMS trước khi hết thời gian). expired — đã hết thời gian.

Xem giá thuê

GET /api.php?action=rental_price&country={code}&operator_id={id}&duration={days}

Xem giá thuê số cố định từ một nhà mạng cụ thể trong khoảng thời gian nhất định.

Tham số	Loại	Bắt buộc	Mô tả
country	string	bắt buộc	Mã quốc gia
operator_id	integer	bắt buộc	ID nhà mạng
duration	integer	bắt buộc	Thời hạn thuê tính bằng ngày: `7`, `14`, `30` hoặc `90`

Phản hồi

{ "price": "12.50", "duration": 30, "operator": "T-Mobile", "type": "physical", "country": "USA" }

Thuê số

POST /api.php?action=rental_buy

Thuê một hoặc nhiều số điện thoại riêng. Số hoàn toàn thuộc về bạn trong toàn bộ thời gian thuê và nhận SMS đến không giới hạn.

Tham số	Loại	Bắt buộc	Mô tả
country	string	bắt buộc	Mã quốc gia
operator_id	integer	bắt buộc	ID nhà mạng
duration	integer	bắt buộc	`7`, `14`, `30` hoặc `90` ngày
qty	integer	tùy chọn	Số lượng số cần thuê (1–10, mặc định: 1)

Phản Hồi Thành Công

{ "success": true, "order_ids": [1848, 1849], "total": 25.00, "qty": 2, "unit_price": 12.50, "duration": 30, "balance": "49.50" }

Lấy thông tin người dùng

GET /api.php?action=user

Trả về thông tin tài khoản và số dư của người dùng hiện tại. Dùng để kiểm tra trạng thái xác thực và số dư khả dụng.

Đã Xác Thực

{ "logged_in": true, "id": 42, "prefix": "AbC3", "balance": "74.50" }

Chưa xác thực

{ "logged_in": false }

Ví dụ quy trình hoàn chỉnh

Dưới đây là ví dụ Python đầy đủ thực hiện xác thực, tìm dịch vụ, mua số và chờ nhận mã SMS:

Python
import requests, time

BASE = "https://smsnokyc.com"
SEED = "AbC3-dEf4-gHj5-kLm6"

s = requests.Session()

# 1. Authenticate
s.post(f"{BASE}/auth-api.php", data={"action": "login", "seed": SEED})

# 2. Check balance
user = s.get(f"{BASE}/api.php?action=user").json()
print(f"Balance: ${user['balance']}")

# 3. Get services for USA
services = s.get(f"{BASE}/api.php?action=services&country=us").json()
whatsapp = next(svc for svc in services if svc["name"] == "WhatsApp")
print(f"WhatsApp: ${whatsapp['price']} ({whatsapp['stock']} in stock)")

# 4. Buy a number
order = s.post(f"{BASE}/api.php?action=buy", json={
    "country": "us",
    "service_id": whatsapp["id"]
}).json()
print(f"Order #{order['order_id']} created")

# 5. Poll for SMS code
for _ in range(60):
    orders = s.get(f"{BASE}/api.php?action=orders").json()
    my_order = next(o for o in orders if o["id"] == order["order_id"])

    if my_order["sms_code"]:
        print(f"SMS code: {my_order['sms_code']}")
        print(f"Phone:    {my_order['phone_number']}")
        break

    print("Waiting for SMS...")
    time.sleep(5)
else:
    print("Timeout — balance will be refunded automatically")

Câu hỏi thường gặp

API xác minh của SMSNoKYC dùng để làm gì?

Nó mở cho chính mã của bạn cùng danh mục như trang web: số ảo ở hơn 190 quốc gia cho xác minh OTP một lần và cho thuê 7-90 ngày. Qua một giao diện REST JSON đơn giản, bạn có thể duyệt ứng dụng, đọc giá trực tiếp, giữ số, lấy mã đến và hoàn tiền cho các lần kích hoạt thất bại — không KYC, chỉ tính phí bằng tiền mã hóa.

Có cần khóa API hay token OAuth không?

Không. Xác thực là một cookie phiên: gửi một lần cụm từ truy cập 16 ký tự của bạn bằng POST tới /auth-api.php, rồi chuyển tiếp cookie trả về ở mỗi lần gọi sau. Không có gì phải cấp phát, xoay vòng hay thu hồi — bạn đăng nhập một lần mỗi phiên và giữ nguyên suốt vòng đời cookie.

API tốn bao nhiêu?

Gọi API miễn phí — không phí hàng tháng, không thuê bao, không khối lượng tối thiểu. Bạn chỉ trả theo số: kích hoạt một lần từ 0,05 $, thuê riêng từ vài đô la cho 7 ngày. Tất cả được trừ vào số dư trả trước của bạn, và mọi lần kích hoạt không nhận được SMS đều tự hoàn tiền.

Những ngôn ngữ và khung nào có thể gọi nó?

Bất cứ thứ gì gửi được yêu cầu HTTPS đều dùng được — Python (requests, httpx), Node.js (fetch, axios), Go, PHP, Ruby, Java, C#, cURL từ Bash và phần còn lại. Tài liệu kèm ví dụ sẵn sàng sao chép bằng cURL, Python và JavaScript, và một tệp OpenAPI 3.0 đầy đủ tại /openapi.json cho phép bạn tạo một client có kiểu trong ngôn ngữ bạn chọn.

Điều gì xảy ra nếu mã xác minh không bao giờ đến?

Mỗi lần kích hoạt có một khung 20 phút. Nếu không có gì đến trước khi khung đóng, đơn tự hủy và toàn bộ giá quay lại số dư — không phiếu hỗ trợ, không thử lại thủ công. Số dư được hoàn có thể tiêu ngay cho một số khác, có thể ở hạng nhà mạng khác (ảo, vật lý hoặc cao cấp) để có tỷ lệ thành công tốt hơn.

API có giới hạn tần suất không?

Đăng nhập bị giới hạn 5 lần thử mỗi 15 phút cho mỗi IP để chặn việc đoán cụm từ. Phần còn lại — danh mục, mua, đơn hàng, thuê — hiện chưa có trần cứng, nhưng hãy giữ khoảng cách hợp lý: hỏi /api.php?action=orders mỗi 3-5 giây là quá đủ để đọc SMS, và các đợt dồn dập kéo dài trên khoảng 10 yêu cầu/giây có thể bị hạn chế ở mức WAF.