API สำหรับผู้ขาย · REST · หมายเลขมือถือจริง

API หมายเลขเสมือน
สำหรับผู้ขาย

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

กว่า 50 ประเทศ
60 คำขอต่อ/นาที ต่อคีย์
คำสั่งที่ไม่ซ้ำกัน
Webhook ที่ลงนามแล้ว

ทำไมต้องสร้างบน VRNUM API แทนที่จะใช้ดีลเครือข่ายของตัวเอง

การจัดหาหมายเลขมือถือจริงจากผู้ให้บริการโดยตรงหมายถึงสัญญาซิม, ฮาร์ดแวร์, ภาระการปฏิบัติตามกฎระเบียบ และเวลาหลายเดือนก่อนที่คุณจะสามารถขายการยืนยันได้เพียงครั้งเดียว VRNUM API จะข้ามขั้นตอนทั้งหมดนั้น

คุณจะสามารถเข้าถึงคลังหมายเลขเสมือนรายเดือนและรายปีสด ๆ ในกว่า 50 ประเทศทันที โดยมีมาร์จินของคุณเองรวมอยู่ในราคาที่ API ส่งคืน ลูกค้าของคุณจะเห็นเพียงแบรนด์และราคาของคุณเท่านั้น

ต้นทุนของคุณยังคงถูกซ่อนอยู่
API จะส่งคืนราคาขายของคุณ ไม่ใช่ต้นทุนภายในของเรา เพิ่มมาร์กอัปของคุณแล้วลูกค้าก็จะไม่เคยเห็นด้านล่างของราคาจริง
หมายเลขเครือข่ายจริง ไม่ใช่ VoIP
หมายเลขมาจากการจัดสรรของเครือข่ายมือถือจริง ดังนั้นจะผ่านการตรวจสอบเครือข่ายที่ปฏิเสธ VoIP และหมายเลขกล่องจดหมายที่แชร์
พร้อมใช้งานภายในไม่กี่นาที ไม่ใช่หลายเดือน
สร้างคีย์, เติมเงินในวอลเล็ตของคุณ และสั่งซื้อครั้งแรก — ไม่มีคิวอนุมัติ, ไม่มีข้อผูกมัดขั้นต่ำ, ไม่มีค่าธรรมเนียม API รายเดือน

จากคีย์ API ถึงการขายครั้งแรกของคุณ

สี่ขั้นตอนสำหรับการรวมผู้ขายที่ใช้งานได้

01

สร้างคีย์ API

สร้างบัญชี VRNUM ฟรีและสร้างคีย์จากแท็บ Developers คีย์ที่ใช้งานได้หนึ่งคีย์ต่อบัญชี

02

เติมเงินในกระเป๋าเงินของคุณ

เติมเงินด้วยคริปโต ทุกคำสั่งซื้อจะถูกหักจากยอดคงเหลือของคุณ — ไม่มีใบแจ้งหนี้ ไม่มีการเรียกเก็บเงินด้วยมือ

03

อ่านแคตตาล็อก

เรียก GET /catalog เพื่อดูประเทศ ที่สมัครใช้งาน และราคาแบบเรียลไทม์ เพิ่มมาร์กอัปของคุณก่อนแสดงข้อมูล

04

จัดสรรตามความต้องการ

POST /numbers พร้อม Idempotency-Key เพื่อกำหนดหมายเลขทันที จากนั้นตรวจสอบหรือใช้เว็บฮุคเพื่อการจัดส่ง

จัดสรรหมายเลขด้วยคำขอเดียว

clientReference คือรหัส ID ที่ไม่เปิดเผยของคุณเอง — แนบมันเพื่อกระทบยอดคำสั่งซื้อกับบันทึกลูกค้าภายในของคุณ

curl -X POST https://vrnum.com/api/v1/numbers \
  -H "Authorization: Bearer vrnum_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8841" \
  -d '{
    "route": "<from catalog>",
    "countryCode": "US",
    "subscriptionOption": "month",
    "clientReference": "order-8841"
  }'

ทุกสิ่งที่คุณต้องการเพื่อจัดการวงจรคำสั่งซื้อทั้งหมด

แคตตาล็อก การจัดเตรียม การดึง SMS การต่ออายุ การต่ออายุอัตโนมัติ และเว็บฮุค — API JSON ที่สอดคล้องกันเพียงชุดเดียว

GET/api/v1/catalog
POST/api/v1/numbers
GET/api/v1/numbers
GET/api/v1/numbers/:id
GET/api/v1/numbers/:id/sms
POST/api/v1/numbers/:id/renew
POST/api/v1/numbers/:id/autorenew
GET / PUT/api/v1/webhook
GET/api/v1/balance

เอกสารคำขอ/คำตอบฉบับเต็มและคีย์ของคุณอยู่ในแดชบอร์ดหลังจากที่คุณเข้าสู่ระบบ

ใครที่สร้างบน API หมายเลขเสมือน

ธุรกิจใด ๆ ที่ต้องการหมายเลขโทรศัพท์จริงโดยไม่ต้องเป็นเจ้าของโครงสร้างพื้นฐานโทรคมนาคม

ผู้ค้าปลีกโทรคมนาคม

เปิดตัวแบรนด์หมายเลขเป็นบริการของคุณเองบนสินค้าคงคลังของผู้ให้บริการที่ใช้งานจริงโดยไม่ต้องมีสัญญา SIM แม้แต่ฉบับเดียว

ผู้ก่อตั้ง SaaS และแอปพลิเคชัน

เพิ่มการจัดเตรียมหมายเลขโทรศัพท์ไปยังกระบวนการ onboarding หรือการยืนยันตัวตนของผลิตภัณฑ์ของคุณด้วยการเรียก API เพียงไม่กี่ครั้ง

เอเจนซีด้านการพัฒนา

ส่งมอบฟีเจอร์การจัดเตรียมหมายเลขสำหรับแอปของลูกค้าโดยไม่ต้องเจรจาข้อตกลงกับผู้ให้บริการของคุณเอง

ทีม QA และอัตโนมัติ

จัดเตรียมหมายเลขจริงแบบใช้ครั้งเดียวตามต้องการสำหรับชุดทดสอบการลงทะเบียนและการยืนยันตัวตนอัตโนมัติ

ออกแบบสำหรับการใช้งานจริง ไม่ใช่แค่สาธิต

คีย์ Idempotency

ลองใหม่อย่างปลอดภัยเมื่อเกิด timeout — คีย์ Idempotency เดียวกันจะส่งกลับคำสั่งเดิมเสมอ ไม่เคยเป็นสำเนาซ้ำ

เว็บฮุคที่มีลายเซ็น

เหตุการณ์ number.provisioned, number.provisioning_failed, และ sms.received ลงลายมือชื่อด้วย X-VRNUM-Signature (HMAC-SHA256)

การลองใหม่โดยอัตโนมัติ

การส่ง webhook ล้มเหลวจะถูกลองใหม่ตามตารางการหน่วงเวลา (5 นาที, 30 นาที, 2 ชั่วโมง, 6 ชั่วโมง, 24 ชั่วโมง) ก่อนที่เราจะยอมแพ้

การจำกัดอัตราที่โปร่งใส

60 คำขอต่อ/นาทีต่อคีย์โดยมีหัวข้อ X-RateLimit-* ในทุกการตอบกลับ ดังนั้นคุณสามารถปรับการหน่วงเวลาได้อย่างคาดการณ์ได้

การเรียกเก็บเงินด้วยกระเป๋าเงิน

ไม่มีใบแจ้งหนี้หรือการสมัครสมาชิกเพื่อเข้าถึง API — คำสั่งซื้อจะถูกหักจากยอดคงเหลือของคุณทันทีที่สำเร็จ

รหัสข้อผิดพลาดที่เสถียร

ข้อผิดพลาดแต่ละรายการจะส่งรหัส JSON มาตรฐานที่การรวมระบบของคุณสามารถสลับใช้ได้อย่างน่าเชื่อถือ ไม่ใช่แค่สถานะ HTTP

คำถามที่พบบ่อย

ฉันสามารถขายต่อหมายเลขเสมือน VRNUM ภายใต้แบรนด์ของตัวเองได้หรือไม่?

ได้ API จะส่งราคาขายต่อของคุณเท่านั้น — ลูกค้าของคุณจะไม่เห็นต้นทุนภายในของ VRNUM หรือแหล่งผู้ให้บริการเบื้องหลัง คุณสามารถกำหนดกำไรต่อประเทศและบริการได้เอง

ฉันจะเข้าถึง API หมายเลขเสมือนได้อย่างไร?

สร้างบัญชี VRNUM ฟรี เปิดแท็บ Developers และสร้างคีย์ API ไม่มีการรอการอนุมัติ ไม่มีค่าธรรมเนียม API รายเดือน — คุณจ่ายจากยอดเงินในกระเป๋าของคุณเมื่อคุณจัดเตรียมหมายเลขเท่านั้น

การยืนยันตัวตนของ API ใช้อะไร?

ใช้การยืนยันตัวตนแบบ Bearer token ส่ง API key ของคุณเป็น Authorization: Bearer header หรือ X-API-Key header ในทุกคำขอ

คำสั่งซื้อซ้ำมีความเสี่ยงถ้าคำขอหมดเวลาไหม?

ไม่มี ทุก endpoint การซื้อรองรับ Idempotency-Key header — ส่งคำขอเดิมพร้อม key เดิมอีกครั้ง คุณจะได้รับคำสั่งเดิมกลับแทนที่จะถูกเรียกเก็บเงินซ้ำ

ฉันจะได้รับการแจ้งเตือนเมื่อหมายเลขพร้อมใช้งานหรือมี SMS มาถึงได้อย่างไร?

ลงทะเบียน webhook URL จากแท็บ Developers VRNUM จะ POST เหตุการณ์ที่ลงลายเซ็นแล้ว (number.provisioned, number.provisioning_failed, sms.received) ไปที่ endpoint ของคุณ โดยจะลองส่งใหม่อัตโนมัติหากการส่งล้มเหลว

ข้อจำกัดอัตราการใช้งาน API คืออะไร?

60 คำขอต่อคีย์ต่อหนึ่งนาที ทุกคำตอบจะมีส่วนหัว X-RateLimit-Limit, X-RateLimit-Remaining และ X-RateLimit-Reset เพื่อให้คุณสามารถลดการเรียกใช้งานได้อย่างถูกต้อง

เริ่มขายหมายเลขเสมือนวันนี้

สร้างบัญชีฟรี สร้างคีย์ API ของคุณ และจองหมายเลขเสมือนแรกของคุณภายในไม่กี่นาที

กำลังเปรียบเทียบผู้ให้บริการหมายเลขเสมือนหรือไม่?