Đăng nhập

API xác minh SMS

Mua số, kiểm tra mã và hủy chỉ bằng một yêu cầu HTTP. Dùng kiểu handler_api phổ biến trong ngành số ảo nên chỉ cần nhập địa chỉ và khóa vào chương trình đăng ký và bot là kết nối ngay.

Lấy khóa API

Sau khi đăng nhập, tạo khóa trong menu API của màn hình Tài khoản. Khóa chỉ hiển thị một lần lúc tạo, hãy lưu lại ngay. API dùng cùng số dư và cùng giá như giao diện web.

Địa chỉ cơ bản

https://nuviosms.com/stubs/handler_api.php?api_key=API_KEY&action=...

Yêu cầu chính

actionViệc làmVí dụ phản hồi
getBalanceKiểm tra số dưACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbGiá và số còn lại theo dịch vụ và quốc gia{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbMua sốACCESS_NUMBER:ID:PHONE
getStatus&id=IDKiểm tra mãSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Hủy số (trước khi có mã, hoàn toàn bộ)ACCESS_CANCEL
setStatus&id=ID&status=3Nhận thêm một mã với cùng sốACCESS_RETRY_GET
setStatus&id=ID&status=6Kết thúc sử dụngACCESS_ACTIVATION

Tham số yêu cầu

TênBắt buộcMô tả
api_keyTất cảKhóa API tạo trên màn hình Tài khoản
actionTất cảgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberMã dịch vụ (ví dụ: telegram, whatsapp, google). Giống địa chỉ trang danh sách dịch vụ
countrygetNumberMã quốc gia hai chữ cái (ví dụ: gb, us, id)
idgetStatus, setStatusID số do getNumber trả về (bắt đầu bằng N-)
statussetStatus8 hủy, 3 nhận mã thêm lần nữa, 6 hoàn tất, 1 sẵn sàng

Chuỗi phản hồi và ý nghĩa

Phản hồiÝ nghĩaTiền
ACCESS_NUMBER:ID:PHONEĐã nhận sốGiá số được trừ
STATUS_WAIT_CODEĐang chờ mãGiữ nguyên
STATUS_OK:CODEMã đã đếnThanh toán hoàn tất
STATUS_WAIT_RETRY:CODEĐang chờ mã tiếp theo (kèm mã trước)Không phí thêm
STATUS_CANCELĐã hủy hoặc hết giờĐược hoàn tiền nếu không có mã
ACCESS_CANCELĐã hủyHoàn toàn bộ
ACCESS_RETRY_GETChờ thêm một mã với cùng sốKhông phí thêm
ACCESS_ACTIVATIONĐã kết thúc dùng sốGiữ nguyên
NO_BALANCENạp số dư là nhận ngayKhông bị trừ
NO_NUMBERSHiện chưa có số của quốc gia nàyKhông bị trừ
NO_ACTIVATIONSĐang mở 20 sốKhông bị trừ
EARLY_CANCEL_DENIEDSố đã nhận mã thì hoàn tất (6) thay vì hủyGiữ nguyên
BAD_KEYKhóa API không đúngKhông bị trừ
BAD_SERVICE / BAD_COUNTRYMã dịch vụ hoặc mã quốc gia không đúngKhông bị trừ
NO_ACTIVATIONKhông tìm thấy ID sốGiữ nguyên
TOO_MANY_REQUESTSĐã vượt 300 lần mỗi phútKhông bị trừ

Ví dụ theo ngôn ngữ

import time, requests

BASE = "https://nuviosms.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Cách sử dụng

  • Nhận số bằng getNumber, nhập số vào màn hình đăng ký rồi gọi getStatus mỗi 5 giây.
  • STATUS_OK:mã đến thì nhập mã đó và kết thúc bằng setStatus 6.
  • Nếu không có mã trong 20 phút, giá số được hoàn tự động vào số dư.
  • Gửi tối đa 300 yêu cầu mỗi phút.