API Số ảo
dành cho Đại lý
Cung cấp số điện thoại ảo hàng tháng và hàng năm một cách lập trình, đặt giá bán lại riêng của bạn và xây dựng thương hiệu xác thực SMS riêng — mà không cần sở hữu bất kỳ SIM nào.
Tại sao nên xây dựng trên API VRNUM thay vì các thỏa thuận nhà mạng riêng của bạn
Lấy số điện thoại di động thực trực tiếp từ các nhà mạng có nghĩa là hợp đồng SIM, phần cứng, chi phí tuân thủ và nhiều tháng chờ đợi trước khi bạn có thể bán một lần xác minh. API VRNUM bỏ qua tất cả những điều đó.
Bạn truy cập ngay lập tức vào kho số ảo hàng tháng và hàng năm ở hơn 50 quốc gia, với lợi nhuận của bạn đã được tính vào mọi mức giá mà API trả về. Khách hàng của bạn chỉ thấy thương hiệu và giá của bạn.
Từ khóa API đến lần bán đầu tiên của bạn
Bốn bước để tích hợp đại lý hoạt động.
Tạo khóa API
Tạo một tài khoản VRNUM miễn phí và tạo khóa từ tab Developers. Mỗi tài khoản chỉ có một khóa hoạt động.
Nạp tiền vào ví
Nạp tiền bằng tiền điện tử. Mỗi đơn hàng sẽ được trừ từ số dư của bạn — không hóa đơn, không tính phí thủ công.
Đọc danh mục
Gọi GET /catalog để xem các quốc gia đang hoạt động, điều khoản đăng ký và giá cả. Thêm phí chênh lệch của bạn trước khi hiển thị chúng.
Cung cấp theo yêu cầu
POST /numbers với Idempotency-Key để gán một số ngay lập tức, sau đó kiểm tra hoặc sử dụng webhook để nhận kết quả.
Cung cấp một số trong một yêu cầu
clientReference là ID không minh bạch của riêng bạn — gắn nó để đối chiếu các đơn hàng với hồ sơ khách hàng nội bộ của bạn.
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"
}'Mọi thứ bạn cần để vận hành chu trình đơn hàng đầy đủ
Danh mục, cung cấp dịch vụ, truy xuất SMS, gia hạn, tự động gia hạn và webhooks — một API JSON nhất quán.
/api/v1/catalog/api/v1/numbers/api/v1/numbers/api/v1/numbers/:id/api/v1/numbers/:id/sms/api/v1/numbers/:id/renew/api/v1/numbers/:id/autorenew/api/v1/webhook/api/v1/balanceTài liệu yêu cầu/phản hồi đầy đủ và các khóa của bạn nằm trongbảng điều khiểnsau khi bạn đăng nhập.
Ai xây dựng trên API số điện thoại ảo
Bất kỳ doanh nghiệp nào cần cung cấp số điện thoại thực mà không sở hữu cơ sở hạ tầng viễn thông.
Nhà bán lại viễn thông
Ra mắt thương hiệu số điện thoại dưới dạng dịch vụ của riêng bạn trên kho số của nhà mạng đang hoạt động mà không cần một hợp đồng SIM nào.
Người sáng lập SaaS & ứng dụng
Thêm tính năng cung cấp số điện thoại vào quy trình hội nhập hoặc xác minh của sản phẩm của bạn chỉ với vài lệnh gọi API.
Các công ty phát triển
Triển khai các tính năng cung cấp số cho ứng dụng của khách hàng mà không cần thương lượng các hợp đồng nhà mạng riêng.
Đội QA & tự động hóa
Cung cấp số điện thoại dùng một lần nhưng thật theo yêu cầu cho các bộ kiểm tra đăng ký và xác minh tự động.
Được xây dựng cho sản xuất, không phải bản demo
Khóa idempotency
Thử lại an toàn khi bị hết thời gian — cùng Idempotency-Key luôn trả về đơn hàng gốc, không bao giờ trùng lặp.
Webhook đã ký
sự kiện number.provisioned, number.provisioning_failed và sms.received, được ký bằng X-VRNUM-Signature (HMAC-SHA256).
Thử lại tự động
Các lần gửi webhook thất bại sẽ được thử lại theo lịch trình tăng dần (5 phút, 30 phút, 2 giờ, 6 giờ, 24 giờ) trước khi chúng tôi từ bỏ.
Giới hạn tỷ lệ minh bạch
60 yêu cầu/phút cho mỗi khóa với các tiêu đề X-RateLimit-* trong mỗi phản hồi, để bạn có thể điều chỉnh lại một cách dự đoán.
Thanh toán từ ví
Không có hóa đơn hay đăng ký cho quyền truy cập API — các đơn hàng sẽ trừ trực tiếp vào số dư của bạn ngay khi chúng thành công.
Mã lỗi ổn định
Mỗi lỗi trả về một mã JSON chuẩn mà tích hợp của bạn có thể dựa vào, không chỉ là trạng thái HTTP.
Các câu hỏi thường gặp
Tôi có thể bán lại các số ảo VRNUM dưới thương hiệu của riêng mình không?
Có. API chỉ trả về giá bán lại của bạn — khách hàng của bạn sẽ không bao giờ thấy chi phí nội bộ của VRNUM hoặc nhà mạng gốc. Bạn có thể tự đặt mức lợi nhuận trên mỗi quốc gia và dịch vụ.
Làm thế nào để tôi truy cập API số ảo?
Tạo một tài khoản VRNUM miễn phí, mở tab Developers (Nhà phát triển), và tạo một khóa API. Không cần chờ phê duyệt, không phí API hàng tháng — bạn chỉ trả từ số dư ví khi bạn cấp phát một số.
API sử dụng xác thực gì?
Xác thực token Bearer. Gửi khóa API của bạn như một header Authorization: Bearer hoặc header X-API-Key trong mỗi yêu cầu.
Có nguy cơ đơn hàng bị trùng lặp nếu một yêu cầu bị hết thời gian không?
Không. Mỗi endpoint mua hàng chấp nhận header Idempotency-Key — thử lại cùng một yêu cầu với cùng một key và bạn sẽ nhận lại đơn hàng gốc thay vì bị tính phí trùng.
Làm thế nào để tôi được thông báo khi một số đã sẵn sàng hoặc SMS đến?
Đăng ký một URL webhook từ tab Developers. VRNUM sẽ POST các sự kiện đã ký (number.provisioned, number.provisioning_failed, sms.received) tới endpoint của bạn, tự động thử lại các lần gửi thất bại.
Giới hạn tốc độ API là gì?
60 yêu cầu mỗi khóa mỗi phút. Mỗi phản hồi bao gồm các tiêu đề X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset để bạn có thể giảm tốc một cách hợp lý.
Bắt đầu bán lại số ảo ngay hôm nay
Tạo tài khoản miễn phí, tạo khóa API của bạn và bố trí số ảo đầu tiên của bạn trong vài phút.