API xác minh SMS

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

Lấy API key

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

Địa chỉ cơ bản

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

Yêu cầu chính

actionCông việcVí dụ phản hồi
getBalanceKiểm tra số dưACCESS_BALANCE:12.50
getPrices&service=telegram&country=krGiá và số còn lại theo dịch vụ{"kr":{"telegram":{"cost":3.2,"count":7922}}}
getNumber&service=telegram&country=krMua 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 mã thêm một lần trên 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ảAPI key tạo trong 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 với địa chỉ trang danh sách dịch vụ
countrygetNumberkr (số 010 Hàn Quốc, bỏ trống cũng là kr)
idgetStatus, setStatusID số do getNumber trả về (bắt đầu bằng N-)
statussetStatus8 hủy, 3 nhận 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ốTiền số được trừ
STATUS_WAIT_CODEĐang chờ mãGiữ nguyên
STATUS_OK:CODEĐã có mãĐã thanh toán
STATUS_WAIT_RETRY:CODEĐang chờ mã tiếp theo (kèm mã trước)Không mất thêm phí
STATUS_CANCELĐã hủy hoặc hết giờĐã 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ã trên cùng sốKhông mất thêm phí
ACCESS_ACTIVATIONĐã dùng xong sốGiữ nguyên
NO_BALANCENạp số dư là nhận được ngayKhông bị trừ
NO_NUMBERSHiện chưa thể cấp 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ì kết thúc (6) thay vì hủyGiữ nguyên
BAD_KEYAPI key 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 yêu cầu mỗi phútKhông bị trừ

Ví dụ theo ngôn ngữ

import time, requests

BASE = "https://010sms.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="kr")
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

  • Lấy 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: khi có mã, nhập mã đó rồi kết thúc bằng setStatus 6.
  • Nếu không nhận được mã trong 20 phút, tiền số tự động được hoàn vào số dư.
  • Gửi tối đa 300 yêu cầu mỗi phút.
API xác minh SMS | 010SMS