- Trang chủ
- API
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.
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.
| Phương thức và đường dẫn | Chức năng |
|---|---|
GET/ | Số dư của bạn bằng USD |
GET/ | Tất cả dịch vụ kèm giá thấp nhất và số quốc gia |
GET/ | Giá một số ở mọi quốc gia cho một dịch vụ |
POST/ | Lấy số cho một dịch vụ và quốc gia, tiền được trừ vào số dư |
GET/ | Trạng thái của số và mọi mã đã nhận đến lúc này |
POST/ | Hủ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
Lấy số Gọi POST /numbers với service và country. Lưu lại id và số.
- 2
Nhập số Nhập số vào dịch vụ sẽ gửi mã.
- 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
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 APIURL 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/v1Authorization: Bearer <API_KEY>Các trường của yêu cầu
| Trường | Dùng trong | Giá trị |
|---|---|---|
service | POST /numbers, GET /prices | Tên dịch vụ lấy từ /services, ví dụ telegram |
country | POST /numbers | Mã quốc gia hai chữ cái, ví dụ gb |
Các trường phản hồi và trạng thái
| Giá trị | Ý nghĩa |
|---|---|
waiting | Số đ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 |
refunded | Không có mã trong 20 phút, tiền đã được trả lại vào số dư |
canceled | Bạ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
unauthorized | Thiếu khóa API hoặc khóa không đúng |
rate_limited | Quá 120 yêu cầu trong một phút |
bad_service | Tên dịch vụ không tồn tại |
bad_country | Quốc gia không có cho dịch vụ đó |
low_balance | Số dư thấp hơn giá |
unavailable | Hiện chưa có số nào. Không bị trừ tiền |
not_found | Tà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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.