- หน้าแรก
- API
API ยืนยัน SMS
ซื้อเบอร์และอ่านรหัสจากซอฟต์แวร์ของคุณเอง API ใช้ยอดเงินของคุณ ราคาเดียวกัน และกฎคืนเงิน 20 นาทีเหมือนบนเว็บไซต์
คุณสร้างคีย์ API ได้ในบัญชีของคุณ เบอร์ที่ซื้อผ่าน API จะหักจากยอดเงินเดียวกันในราคาเดียวกับเว็บไซต์
ข้อมูลสำคัญ
- ราคาต่ำสุดต่อเบอร์
- $0.0018
- การยืนยันตัวตน
- คีย์ API
- รูปแบบ
- JSON ผ่าน HTTPS
- จำกัดคำขอ
- 120 คำขอต่อนาที
- คืนเงิน
- เหมือนบนเว็บไซต์
REST และ JSON
6 คำขอครอบคลุมยอดเงิน บริการ ราคา การรับเบอร์ สถานะ และการยกเลิก
คีย์จากบัญชีของคุณ
สร้างคีย์ในหน้าคีย์ API ของบัญชี แล้วส่งในเฮดเดอร์ Authorization
ราคาเดียวกับเว็บไซต์
ราคาเบอร์และกฎคืนเงิน 20 นาทีเหมือนบนเว็บไซต์
ส่งคำขออะไรได้บ้าง
พาธต่อท้าย URL หลัก ทุกคำขอต้องมีคีย์ API ของคุณ
| เมธอดและพาธ | ทำอะไร |
|---|---|
GET/ | ยอดเงินของคุณเป็น USD |
GET/ | บริการทั้งหมด พร้อมราคาต่ำสุดและจำนวนประเทศ |
GET/ | ราคาของ 1 เบอร์ในทุกประเทศสำหรับบริการหนึ่ง |
POST/ | รับเบอร์สำหรับบริการและประเทศ ราคาจะหักจากยอดเงินของคุณ |
GET/ | สถานะของเบอร์และทุกรหัสที่ได้รับจนถึงตอนนี้ |
POST/ | ยกเลิกก่อนรหัสมาถึง เงินจะคืนเข้ายอดเงินของคุณ |
เรียกใช้ API ตามลำดับอย่างไร
- 1
รับเบอร์ POST /numbers พร้อม service และ country แล้วบันทึก id และเบอร์ไว้
- 2
กรอกเบอร์ พิมพ์เบอร์ลงในบริการที่จะส่งรหัส
- 3
ตรวจสอบรหัส GET /numbers/{id} ทุก 5 วินาที จนกว่ารายการ codes จะไม่ว่าง
- 4
เสร็จสิ้น ใช้รหัส หากไม่ต้องการเบอร์แล้วก่อนรหัสมาถึง ให้ยกเลิก
รับคีย์ API อย่างไร
เข้าสู่ระบบแล้วเปิดเมนูคีย์ API ในบัญชีของคุณ สร้างคีย์และคัดลอกทันที เพราะจะแสดงเพียงครั้งเดียว การสร้างคีย์ใหม่จะทำให้คีย์เดิมใช้ไม่ได้
คีย์ APIURL หลักคืออะไร
ส่งทุกคำขอไปที่ที่อยู่นี้ พร้อมคีย์ในเฮดเดอร์ Authorization (Bearer) หรือเฮดเดอร์ X-Api-Key:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>ฟิลด์ในคำขอ
| ฟิลด์ | ใช้ใน | ค่า |
|---|---|---|
service | POST /numbers, GET /prices | ชื่อบริการจาก /services เช่น telegram |
country | POST /numbers | รหัสประเทศ 2 ตัวอักษร เช่น gb |
ฟิลด์ในการตอบกลับและสถานะ
| ค่า | ความหมาย |
|---|---|
waiting | เบอร์เปิดอยู่และยังไม่มีรหัสเข้ามา |
received | มีรหัสเข้ามาอย่างน้อย 1 รหัส และยังรับเพิ่มได้จนถึง expires_at |
refunded | ไม่มีรหัสภายใน 20 นาที เงินคืนเข้ายอดเงินของคุณแล้ว |
canceled | คุณยกเลิกก่อนรหัสมาถึง เงินคืนเข้ายอดเงินของคุณแล้ว |
ตัวอย่างการตอบกลับ
{ "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" } ]}รหัสข้อผิดพลาด
unauthorized | ไม่มีคีย์ API หรือคีย์ไม่ถูกต้อง |
rate_limited | เกิน 120 คำขอภายใน 1 นาที |
bad_service | ไม่รู้จักชื่อบริการ |
bad_country | ประเทศนี้ไม่มีสำหรับบริการนั้น |
low_balance | ยอดเงินน้อยกว่าราคา |
unavailable | ตอนนี้ไม่มีเบอร์ว่าง ไม่มีการหักเงิน |
not_found | ไม่มีเบอร์ที่มี id นี้ในบัญชีของคุณ |
cannot_cancel | มีรหัสเข้ามาแล้วหรือเบอร์ปิดแล้ว |
ตัวอย่างโค้ด
# 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"]])คำถามที่พบบ่อยเกี่ยวกับ API ยืนยัน SMS
API ยืนยัน SMS คืออะไร
วิธีซื้อเบอร์และอ่านรหัสจากโปรแกรมของคุณเองแทนการใช้เว็บไซต์
ใช้ API มีค่าใช้จ่ายเพิ่มไหม
ไม่มี เบอร์ราคาเท่ากับบนเว็บไซต์และจ่ายจากยอดเงินเดียวกัน
ส่งคำขอได้กี่ครั้ง
สูงสุด 120 คำขอต่อนาทีต่อคีย์ การตรวจสอบทุก 5 วินาทียังอยู่ในขีดจำกัดสบายๆ
เบอร์ที่ซื้อผ่าน API ได้เงินคืนด้วยไหม
ได้ ใช้กฎเดียวกัน: ไม่มีรหัสภายใน 20 นาที เงินจะคืนเข้ายอดเงินของคุณ
สร้างคีย์ได้ที่ไหน
ในบัญชีของคุณ ที่เมนูคีย์ API