208 แอป154 ประเทศ

API เวอร์ชัน 12026-11-04

API แบบ JSON สำหรับการสั่งซื้อหมายเลขยืนยันและการอ่านรหัส SMS

URL หลัก https://snsverify.com/api/v1

ทุกเส้นทางในหน้านี้สัมพันธ์กับ URL นี้ จำนวนเงินเป็นดอลลาร์สหรัฐในรูปแบบสตริงทศนิยมสองตำแหน่ง เวลาเป็น UTC (ISO 8601)

สองรูปแบบ บัญชีเดียว

หน้านี้อธิบาย REST API ที่ใช้ JSON หากเครื่องมือของคุณรองรับรูปแบบ SMS activation ทั่วไป (handler_api.php พร้อมพารามิเตอร์ action=) ให้ใช้ SMS activation API ทั้งสองรูปแบบใช้ API key, ราคา, การเปิดใช้งานที่ยังไม่เสร็จสิ้น และการคืนเงินร่วมกัน

ภาพรวม

API การยืนยัน SMS ช่วยให้ซอฟต์แวร์ของคุณสามารถซื้อหมายเลขโทรศัพท์สำหรับแอป รอรับ SMS ยืนยันและอ่านรหัสได้ โดยไม่ต้องเปิดเว็บไซต์ แต่ละคำสั่งซื้อคือการเปิดใช้งานหนึ่งครั้ง: บริการหนึ่งรายการ ประเทศหนึ่งรายการ หมายเลขหนึ่งรายการ และหน้าต่างเวลา 20 นาที คำสั่งซื้อที่ไม่มีรหัสจะได้รับเงินคืนเต็มจำนวนเมื่อสิ้นสุดหน้าต่างเวลา

คำขอใช้ GET สำหรับการอ่านและ POST สำหรับการดำเนินการ เนื้อหา POST สามารถเป็นฟิลด์ฟอร์มหรือ JSON คำตอบที่สำเร็จเป็นออบเจ็กต์ JSON ข้อผิดพลาดมีรูปแบบเดียวกันทุกที่: {"error":{"code":"...","message":"..."}}.

การยืนยันตัวตน

สร้าง API key ในคอนโซลภายใต้ API key จะแสดงเพียงครั้งเดียว เราเก็บเฉพาะสำเนาที่เข้ารหัสเท่านั้น ส่งในส่วนหัว Authorization เป็น bearer token พารามิเตอร์ key ก็ยอมรับได้สำหรับเครื่องมือที่ไม่สามารถตั้งค่าส่วนหัวได้

Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

การสร้าง key ใหม่จะแทนที่ key เก่าทันที endpoints บริการ ประเทศ และราคาทำงานโดยไม่ต้องใช้ key

ข้อผิดพลาด

HTTPความหมาย
400ฟิลด์หายไปหรือไม่ถูกต้อง (missing_filter, bad_json)
401ไม่มี key หรือ key ผิด (no_key, bad_key)
402เครดิตไม่เพียงพอ (no_balance)
404บริการ ประเทศ คำสั่งซื้อ หรือ endpoint ไม่รู้จัก
409คำสั่งซื้อไม่สามารถดำเนินการได้ในขณะนี้ (has_code, not_ready, too_many_open, no_numbers)
429มากกว่า 300 คำขอในหนึ่งนาที (rate_limited)

เริ่มต้นอย่างรวดเร็ว

สั่งซื้อหมายเลข WhatsApp สหราชอาณาจักรด้วย curl จากนั้นตรวจสอบคำสั่งซื้อทุกๆ ไม่กี่วินาทีจนกว่ารหัสจะมา

curl -X POST https://snsverify.com/api/v1/orders \
  -H "Authorization: Bearer $SNSVERIFY_KEY" \
  -d service=whatsapp -d country=gb

Python

import os, time, requests

API = "https://snsverify.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSVERIFY_KEY']}"}

order = requests.post(f"{API}/orders", headers=H,
    data={"service": "whatsapp", "country": "gb"}).json()["order"]
print("Use this number:", order["phone"])

while True:
    o = requests.get(f"{API}/orders/{order['id']}", headers=H).json()["order"]
    if o["code"] or o["status"] in ("refunded", "canceled"):
        break
    time.sleep(4)
print("Code:", o["code"])

Node.js

const API = "https://snsverify.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSVERIFY_KEY}` };

const { order } = await fetch(`${API}/orders`, {
  method: "POST", headers: H,
  body: new URLSearchParams({ service: "telegram", country: "nl" }),
}).then((r) => r.json());
console.log("Use this number:", order.phone);

let o = order;
while (!o.code && !["refunded", "canceled"].includes(o.status)) {
  await new Promise((r) => setTimeout(r, 4000));
  ({ order: o } = await fetch(`${API}/orders/${order.id}`, { headers: H }).then((r) => r.json()));
}
console.log("Code:", o.code);

ขีดจำกัดอัตรา

300 คำขอต่อนาทีต่อ key และไม่เกิน 20 คำสั่งซื้อที่เปิดอยู่ต่อบัญชี การตรวจสอบคำสั่งซื้อทุก 3 ถึง 5 วินาทีก็เพียงพอ: รหัสส่วนใหญ่มาถึงภายในหนึ่งนาที

สถานะคำสั่งซื้อ

  • waiting หมายเลขเปิดอยู่และยังไม่ได้รับรหัส
  • received ได้รับรหัสอย่างน้อยหนึ่งรหัส ขอรหัสเพิ่มเติมด้วย resend ในขณะที่หน้าต่างยังเปิดอยู่
  • finished ปิดหลังจากได้รับรหัส โดยคุณหรือเมื่อสิ้นสุดหน้าต่างเวลา
  • refunded หน้าต่างเวลาสิ้นสุดลงโดยไม่มีรหัส เงินเต็มจำนวนจะกลับเข้าสู่เครดิตของคุณ
  • canceled คุณยกเลิกก่อนได้รับรหัส เงินเต็มจำนวนจะกลับเข้าสู่เครดิตของคุณ

จุดปลายทาง

GET/services

รหัสบริการทุกรายการพร้อมชื่อ หมวดหมู่และราคาต่ำสุด ไม่ต้องใช้ key

{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}

GET/countries

รหัสประเทศทุกรายการ (ISO ตัวพิมพ์เล็ก) พร้อมชื่อและรหัสโทร ไม่ต้องใช้ key

{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}

GET/prices?service=whatsapp&country=gb

ราคาเป็น USD กรองตามบริการ ประเทศหรือทั้งสองอย่าง ไม่ต้องใช้ key

{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}

GET/balance

เครดิตของคุณเป็น USD

{"balance":"25.00","currency":"USD"}

POST/orders

ซื้อหมายเลข (HTTP 201) ส่งคืนคำสั่งซื้อพร้อมหมายเลขโทรศัพท์และเวลาที่หน้าต่างสิ้นสุด

เนื้อหา: service=whatsapp&country=gb

{"order":{"id":"AC-7K2M9QX4PB","service":"whatsapp","country":"gb","phone":"+447700900123","price":"0.94","status":"waiting","code":null,"expires_at":"2026-11-04T12:20:00.000Z"},"window_minutes":20}

GET/orders/AC-7K2M9QX4PB

คำสั่งซื้อหนึ่งรายการพร้อมสถานะและรหัสที่ได้รับทั้งหมด สถานะ: waiting, received, finished, refunded, canceled

{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}

GET/orders?status=open

คำสั่งซื้อที่เปิดอยู่ของคุณ status=all ส่งคืน 100 รายการล่าสุด

{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}

POST/orders/AC-7K2M9QX4PB/resend

ขอรหัสเพิ่มเติมในหมายเลขเดียวกันหลังจากรหัสแรก ในขณะที่หน้าต่างยังเปิดอยู่ ไม่มีค่าใช้จ่ายเพิ่มเติม

{"order":{"status":"received","waiting_for_resend":true}}

POST/orders/AC-7K2M9QX4PB/finish

ปิดคำสั่งซื้อที่ได้รับรหัสแล้ว

{"order":{"status":"finished"}}

POST/orders/AC-7K2M9QX4PB/cancel

ยกเลิกก่อนได้รับรหัส เงินเต็มจำนวนจะกลับเข้าสู่เครดิตของคุณ

{"order":{"status":"canceled","refunded":"0.94"}}
SMS Verification API: REST JSON สำหรับหมายเลข WhatsApp, Telegram และ Google | SNSVerify