API Xác thực OTP
cho các Nhà bán lại
Bán lại các số xác minh SMS dùng một lần từ 0,10 USD thông qua một REST API. Cấp phát ngay lập tức, hoàn tiền đầy đủ cho các kích hoạt chưa sử dụng, và webhooks đã ký — xây dựng nền tảng OTP của riêng bạn dựa trên các số điện thoại thực của nhà mạng.
Một API cho mọi xác minh SMS dùng một lần mà bạn cần
Các hộp thư SMS công cộng miễn phí có thể đọc công khai và đã bị đánh dấu bởi tất cả các nền tảng lớn. Xây dựng quan hệ với nhà mạng cho các số dùng một lần rất tốn kém cho thứ mà khách hàng chỉ dùng một lần rồi bỏ.
VRNUM OTP API cung cấp cho bạn một kho số thực của nhà mạng sống riêng tư theo nhu cầu. Cấp phát một số, nhận mã, và số đó sẽ không bao giờ được hiển thị cho bất kỳ ai khác — với mức giá bạn đã áp dụng cho mỗi giá bạn hiển thị.
Từ đơn hàng đến mã đã xác minh
Bốn lần gọi bao quát toàn bộ vòng đời OTP.
Kiểm tra danh mục
GET /otp-catalog để xem dịch vụ, quốc gia và giá hiện tại — áp dụng mức lợi nhuận của bạn trước khi hiển thị cho khách hàng.
Đặt số
POST /otp-numbers với dịch vụ, quốc gia và Idempotency-Key. Một số sẽ được trả về ngay lập tức.
Nhận mã
GET /otp-numbers/:id kiểm tra trực tiếp SMS, hoặc chờ sự kiện webhook otp.completed.
Gửi lại hoặc hoàn tiền
Chưa có mã? Thử /resend, hoặc /cancel để hoàn tiền đầy đủ ngay lập tức vào ví của bạn.
Đặt số OTP trong một yêu cầu
clientReference là ID mờ 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/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'Vòng đời đầy đủ của đơn hàng OTP
Danh mục, đặt hàng, gửi lại, hủy/hoàn tiền và webhooks — một API JSON nhất quán.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/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 dựa trên API xác thực OTP
Bất kỳ sản phẩm nào cần một số điện thoại thực cho một bước xác thực duy nhất.
Nền tảng xác thực SMS
Bán lại số OTP cho khách hàng của bạn dưới thương hiệu của bạn, với mức đánh dấu riêng trên mỗi dịch vụ.
QA & tự động hóa kiểm thử
Tạo tài khoản thử nghiệm dùng một lần trên các dịch vụ sản xuất mà không sử dụng số điện thoại cá nhân.
Công cụ cho bot & agency
Cấp số điện thoại tự động cho các quy trình tạo tài khoản được xây dựng cho khách hàng.
Công cụ cho nhà phát triển
Cung cấp 'xác minh bằng SMS' như một tính năng trong ứng dụng hoặc SDK của riêng bạn mà không cần sở hữu hạ tầng viễn thông.
Đủ tin cậy để bạn có thể tính phí khách hàng của mình
Khóa tính đơn nhất (Idempotency keys)
Thử lại an toàn khi bị hết thời gian chờ — cùng một Idempotency-Key luôn trả về đơn hàng gốc, không bao giờ tạo bản sao.
Webhook được ký
Các sự kiện otp.completed, number.provisioned và number.provisioning_failed, được ký bằng X-VRNUM-Signature.
Thử lại tự động
Các lần giao webhook thất bại sẽ được thử lại theo lịch trễ (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ốc độ 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.
Thanh toán qua ví
Không có hóa đơn hay đăng ký — đơn hàng và hoàn tiền sẽ được ghi vào số dư của bạn ngay khi chúng xảy ra.
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ể tin cậy để xử lý.
Câu hỏi thường gặp
Tôi có thể bán lại số OTP thông qua API VRNUM không?
Có. Các đầu cuối otp-catalog và otp-numbers chỉ trả về giá bán lại của bạn. Bạn có thể đặt biên lợi nhuận riêng cho từng dịch vụ và quốc gia — khách hàng của bạn sẽ không bao giờ thấy chi phí nội bộ của VRNUM.
Điều gì xảy ra nếu mã OTP không bao giờ đến?
Gọi POST /otp-numbers/:id/cancel trên một kích hoạt vẫn đang chờ để hoàn một khoản hoàn lại đầy đủ vào ví của bạn. Bạn cũng có thể gọi endpoint gửi lại trước.
Một kích hoạt OTP có thời hạn hiệu lực bao lâu qua API?
Mỗi kích hoạt tồn tại trong 20 phút kể từ khi được tạo. Hủy trước khi hết hạn để được hoàn tiền đầy đủ nếu mã không đến.
Làm sao để tránh tính phí khách hàng hai lần khi thử lại?
Gửi header Idempotency-Key trên POST /otp-numbers. Thử lại cùng một yêu cầu với cùng một key sẽ trả về đơn hàng gốc thay vì tạo một đơn mới.
Tôi có thể nhận các sự kiện giao hàng theo thời gian thực thay vì kiểm tra định kỳ không?
Có. Đăng ký một endpoint webhook và nhận các sự kiện otp.completed đã ký ngay khi chúng xảy ra, thay vì kiểm tra định kỳ.
Những dịch vụ nào được hỗ trợ qua API?
Hơn 80 dịch vụ bao gồm WhatsApp, Telegram, Google, Instagram, Facebook, Discord và nhiều dịch vụ khác. Gọi GET /otp-catalog để xem danh sách trực tiếp.
Bắt đầu bán lại số OTP ngay hôm nay
Tạo tài khoản miễn phí, tạo khóa API của bạn và cấp phát số OTP đầu tiên chỉ trong vài phút.