API xác minh SMS

API SNSSIM xử lý mua số, kiểm tra mã, hủy, kiểm tra credit và giá chỉ bằng một yêu cầu HTTP. Sử dụng phương thức handler_api tiêu chuẩn ngành, chỉ cần thay đổi địa chỉ và API key là có thể kết nối ngay với chương trình hiện có.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Phương thức tiêu chuẩn ngành
handler_api

Phương thức tiêu chuẩn ngành

Mỗi API key
300 lần mỗi phút

Mỗi API key

Quốc gia / Dịch vụ
145 / 1,255

Quốc gia / Dịch vụ

Tự động hoàn tiền nếu không có mã
20 phút

Tự động hoàn tiền nếu không có mã

Nhận API key như thế nào?

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

Địa chỉ cơ bản là gì?

Mọi yêu cầu được gửi bằng phương thức GET đến cùng địa chỉ với api_key và action.

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

Bạn có thể gửi những yêu cầu nào?

Tổng cộng có 7 loại yêu cầu từ mua số, kiểm tra mã, hủy bỏ đến kiểm tra số dư.

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ử dụng số (hoàn tiền toàn bộ nếu không nhận được mã)ACCESS_CANCEL
setStatus&id=ID&status=3Nhận mã xác thực bổ sung từ 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á trị giống với trang danh sách dịch vụ
countrygetNumberMã quốc gia 2 chữ cái (ví dụ: gb, us, id)
idgetStatus, setStatusID số đã nhận từ getNumber (bắt đầu bằng N)
statussetStatus8 để hủy, 3 để yêu cầu lại mã, 6 để kết thúc, 1 để chuẩn bị

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

Phản hồi được cung cấp dưới dạng văn bản ngắn gọn. Kèm theo thông tin trừ credit.

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ã xác minh bổ sung (bao gồ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_GETĐang chờ nhận mã từ cùng số điện thoại lần nữaKhô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 tại không thể cung cấp số điện thoại cho quốc gia nàyKhông bị trừ
NO_ACTIVATIONSĐang mở 20 sốKhông bị trừ
EARLY_CANCEL_DENIEDĐối với số điện thoại đã nhận mã xác minh, hãy chọn kết thúc (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 quốc gia không chính xácKhô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ừ

Quy trình nhận code qua API?

Quy trình 4 bước: nhận số, nhập số, kiểm tra mã và hoàn tất.

  1. 1 bước

    Nhận số

    Chọn dịch vụ và quốc gia mong muốn trong getNumber để nhận số.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 bước

    Nhập số

    Nhập số đã mua vào trang đăng ký hoặc chương trình.

    +44 7700 900123
  3. 3 bước

    Kiểm tra mã

    Kiểm tra mã đã đến chưa bằng cách gọi getStatus mỗi 5 giây.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 bước

    Kết thúc

    Sau khi nhập mã, hãy hoàn tất bằng setStatus 6. Nếu không có mã trong 20 phút, sẽ tự động hoàn tiền.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Ví dụ theo ngôn ngữ

Đây là toàn bộ quy trình từ nhận số, chờ mã đến hoàn tất. Nhấn vào tab để đổi ngôn ngữ.

import time, requests

BASE = "https://snssim.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âu hỏi thường gặp về API

API cung cấp số điện thoại từ 1,255 dịch vụ tại 145 quốc gia với giá giống như trên web.

API xác thực SMS là gì?
Tính năng xử lý mua số ảo, kiểm tra mã xác minh và hủy bằng HTTP request trong chương trình. API SNSSIM dùng chuẩn handler_api của ngành.
Tôi có thể tiếp tục sử dụng chương trình đã dùng trên các trang xác thực SMS khác không?
Nếu dùng chương trình hỗ trợ handler_api, chỉ cần thay đổi địa chỉ cơ bản và API key là kết nối ngay.
Có phí riêng cho API không?
Không có sự khác biệt. API và giao diện web sử dụng cùng một credit và giá cả.
Có thể yêu cầu tối đa bao nhiêu lần?
Mỗi API key tối đa 300 yêu cầu mỗi phút. Vượt quá sẽ gặp lỗi TOO_MANY_REQUESTS và credit không bị trừ.
Số mua qua API có được hoàn tiền không?
Có. Nếu mã không đến trong 20 phút, số mua qua API cũng sẽ được tự động hoàn lại vào credit.
Tạo API key ở đâu?
Tạo trong menu API trên màn hình tài khoản sau khi đăng nhập. Khóa chỉ hiển thị một lần khi tạo, vui lòng lưu ngay.

Tạo API key và kết nối ngay

Sau khi đăng ký, nạp credit vào tài khoản để có thể tạo khóa API ngay tại màn hình tài khoản.

API xác minh SMS | SNSSIM