Chuyển đến nội dung
tomnumber

API xác minh SMS

Mua số và đọc mã từ phần mềm của bạn. API dùng số dư của bạn, cùng giá và cùng quy tắc hoàn tiền sau 20 phút như trên trang web.

Bạn tạo khóa API trong tài khoản. Số mua qua API được trừ vào cùng số dư với cùng mức giá như trên trang web.

Tạo tài khoảnKhóa API

Từ $0.0018 mỗi số

Thông tin chính

Giá thấp nhất mỗi số
$0.0018
Xác thực
Khóa API
Định dạng
JSON qua HTTPS
Giới hạn tần suất
120 yêu cầu mỗi phút
Hoàn tiền
Giống trên trang web

REST và JSON

Sáu yêu cầu cho số dư, dịch vụ, giá, lấy số, trạng thái và hủy.

Khóa từ tài khoản của bạn

Tạo khóa ở trang Khóa API trong tài khoản và gửi khóa trong header Authorization.

Cùng giá với trang web

Giá số và quy tắc hoàn tiền sau 20 phút giống hệt trên trang web.

Tôi gửi được những yêu cầu nào?

Đường dẫn đặt sau URL gốc. Mọi yêu cầu đều cần khóa API của bạn.

Tôi gửi được những yêu cầu nào?
Phương thức và đường dẫnChức năng
GET/balanceSố dư của bạn bằng USD
GET/servicesTất cả dịch vụ kèm giá thấp nhất và số quốc gia
GET/prices?service=telegramGiá một số ở mọi quốc gia cho một dịch vụ
POST/numbersLấy số cho một dịch vụ và quốc gia, tiền được trừ vào số dư
GET/numbers/{id}Trạng thái của số và mọi mã đã nhận đến lúc này
POST/numbers/{id}/cancelHủy trước khi mã đến, tiền được trả lại vào số dư

Gọi API theo thứ tự nào?

  1. 1

    Lấy số Gọi POST /numbers với service và country. Lưu lại id và số.

  2. 2

    Nhập số Nhập số vào dịch vụ sẽ gửi mã.

  3. 3

    Kiểm tra mã Gọi GET /numbers/{id} mỗi 5 giây cho đến khi danh sách codes không còn trống.

  4. 4

    Hoàn tất Dùng mã. Nếu không cần số nữa trước khi mã đến, hãy hủy số.

Lấy khóa API như thế nào?

Đăng nhập và mở mục Khóa API trong tài khoản. Tạo khóa và sao chép ngay, vì khóa chỉ hiện một lần. Tạo khóa mới sẽ vô hiệu hóa khóa cũ.

Khóa API

URL gốc là gì?

Gửi mọi yêu cầu đến địa chỉ này, kèm khóa trong header Authorization (Bearer) hoặc header X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Các trường của yêu cầu

Các trường của yêu cầu
TrườngDùng trongGiá trị
servicePOST /numbers, GET /pricesTên dịch vụ lấy từ /services, ví dụ telegram
countryPOST /numbersMã quốc gia hai chữ cái, ví dụ gb

Các trường phản hồi và trạng thái

Các trường phản hồi và trạng thái
Giá trịÝ nghĩa
waitingSố đang mở và chưa có mã nào đến
receivedĐã có ít nhất một mã, vẫn có thể nhận thêm cho đến expires_at
refundedKhông có mã trong 20 phút, tiền đã được trả lại vào số dư
canceledBạn đã hủy trước khi mã đến, tiền đã được trả lại vào số dư

Ví dụ phản hồi

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Mã lỗi

Mã lỗi
unauthorizedThiếu khóa API hoặc khóa không đúng
rate_limitedQuá 120 yêu cầu trong một phút
bad_serviceTên dịch vụ không tồn tại
bad_countryQuốc gia không có cho dịch vụ đó
low_balanceSố dư thấp hơn giá
unavailableHiện chưa có số nào. Không bị trừ tiền
not_foundTài khoản của bạn không có số với id đó
cannot_cancelĐã có mã đến hoặc số đã đóng

Ví dụ mã nguồn

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

Hỏi đáp về API xác minh SMS

API xác minh SMS là gì?

Là cách mua số và đọc mã từ chương trình của bạn thay vì dùng trang web.

Dùng API có tốn thêm phí không?

Không. Giá số giống trên trang web và trừ vào cùng một số dư.

Tôi gửi được bao nhiêu yêu cầu?

Tối đa 120 yêu cầu mỗi phút cho mỗi khóa. Kiểm tra mỗi 5 giây vẫn thấp hơn nhiều so với giới hạn đó.

Số lấy qua API có được hoàn tiền không?

Có, theo cùng quy tắc: không có mã trong 20 phút thì tiền được trả lại vào số dư.

Tạo khóa ở đâu?

Trong tài khoản, ở mục Khóa API.

Số ảo cho dịch vụ khác