واجهة برمجة تطبيقات التحقق من OTP
للموزعين
إعادة بيع أرقام التحقق عبر الرسائل القصيرة للاستخدام لمرة واحدة ابتداءً من 0.10 دولار من خلال واجهة برمجة تطبيقات REST واحدة. توفير فوري، استرداد كامل للتفعيلات غير المستخدمة، وخدمات ويب موقعة — ابنِ منصتك الخاصة للتحقق عبر كلمة المرور لمرة واحدة باستخدام أرقام حقيقية من شركات الاتصالات.
واجهة برمجة تطبيقات واحدة لكل عمليات التحقق عبر الرسائل القصيرة لمرة واحدة التي تحتاجها
صناديق الرسائل العامة المجانية قابلة للقراءة من قبل الجميع وقد تم وضع علامات عليها بالفعل من قبل كل منصة رئيسية. بناء علاقاتك الخاصة مع شركات الاتصالات للحصول على أرقام للاستخدام لمرة واحدة مكلف لإعداد شيء يستخدمه العملاء مرة واحدة ثم يتخلصون منه.
توفر واجهة برمجة تطبيقات VRNUM OTP لك مجموعة حية وخاصة من أرقام شركات الاتصالات عند الطلب. قم بتوفير رقم واحد، واستلم الرمز، ولن يُعرض الرقم لأي شخص آخر — مع تطبيق هامشك بالفعل على كل سعر تعرضه.
من الطلب إلى الكود المؤكد
أربع مكالمات تغطي دورة حياة OTP بأكملها.
تحقق من الكتالوج
GET /otp-catalog للخدمات الحية والدول والأسعار — قم بتطبيق هامشك قبل عرضها على العملاء.
طلب رقم
POST /otp-numbers مع خدمة، بلد، و Idempotency-Key. يتم إرجاع الرقم على الفور.
الحصول على الرمز
GET /otp-numbers/:id يتحقق مباشرة من الرسائل القصيرة، أو انتظر حدث webhook otp.completed.
إعادة الإرسال أو الاسترداد
لم تحصل على الرمز بعد؟ جرب /resend، أو /cancel لاسترداد كامل فوري إلى محفظتك.
طلب رقم OTP في طلب واحد
clientReference هو معرفك الخاص غير الشفاف — أرفقه لمطابقة الطلبات مع سجلات العملاء الداخلية.
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"
}'دورة حياة كاملة لطلب OTP
الكatalog، الطلب، إعادة الإرسال، الإلغاء/الاسترداد، و webhooks — واجهة برمجة تطبيقات JSON موحدة.
/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/balanceFull request/response docs and your keys live in your dashboard after you sign in.
Who builds on the OTP verification API
Any product that needs a real phone number for a single verification step.
SMS verification platforms
Resell OTP numbers to your own customers under your brand, with your own markup on every service.
QA & test automation
Create disposable test accounts on production services without burning personal phone numbers.
Bot & agency tooling
توفير الأرقام برمجيًا لعمليات إنشاء الحسابات المصممة للعملاء.
أدوات المطورين
قدم ميزة 'التحقق عبر الرسائل القصيرة' في تطبيقك أو SDK الخاص بك دون الحاجة لامتلاك بنية تحتية للاتصالات.
موثوق بما يكفي لفوترة العملاء الخاصين بك
مفاتيح الإرجاع الأحادي (Idempotency keys)
أعد المحاولة بأمان عند حدوث مهلة — نفس مفتاح الإرجاع الأحادي يعيد الطلب الأصلي دائمًا، ولا ينشئ نسخة مكررة.
Webhooks موقعة
eventات otp.completed و number.provisioned و number.provisioning_failed، موقعة باستخدام X-VRNUM-Signature.
إعادة المحاولة التلقائية
إعادة المحاولة لتوصيل webhooks الفاشلة وفق جدول تراجع (5 دقائق، 30 دقيقة، ساعتان، 6 ساعات، 24 ساعة) قبل أن نتخلى.
حدود السرعة الشفافة
60 طلبًا/دقيقة لكل مفتاح مع رؤوس X-RateLimit-* في كل استجابة.
الفوترة الممولة عبر المحفظة
لا فواتير أو اشتراكات — يتم تسجيل الطلبات والمبالغ المستردة في رصيدك فور حدوثها.
رموز الأخطاء الثابتة
كل خطأ يُرجع رمز JSON موحد يمكن لتكامل النظام الخاص بك الاعتماد عليه بشكل موثوق.
الأسئلة المتكررة
هل يمكنني إعادة بيع أرقام OTP عبر واجهة برمجة تطبيقات VRNUM؟
نعم. تُرجع نقاط النهاية otp-catalog و otp-numbers سعر إعادة البيع الخاص بك فقط. قم بتحديد الهامش الخاص بك لكل خدمة وكل دولة — عملاؤك لن يروا أبدًا تكلفة VRNUM الداخلية.
ماذا يحدث إذا لم يصل رمز OTP أبدًا؟
قم باستدعاء POST /otp-numbers/:id/cancel على تفعيل ما يزال في الانتظار لاسترداد كامل إلى محفظتك. يمكنك أيضًا استدعاء نقطة إعادة الإرسال أولاً.
كم من الوقت تظل تفعيل OTP صالحًا عبر واجهة برمجة التطبيقات؟
يظل كل تفعيل نشطًا لمدة 20 دقيقة من تاريخ الإنشاء. قم بالإلغاء قبل انقضائه لاسترداد كامل إذا لم تصل أي رمز.
كيف أتجنب تحصيل رسوم مزدوجة من العميل عند إعادة المحاولة؟
أرسل رأس Idempotency-Key عند POST /otp-numbers. إعادة محاولة نفس الطلب بنفس المفتاح تُعيد الطلب الأصلي بدلاً من إنشاء طلب جديد.
هل يمكنني الحصول على أحداث التسليم في الوقت الفعلي بدلًا من الاستطلاع؟
نعم. سجل نقطة توصيل ويب هوك وتلقى أحداث otp.completed الموقعة فور حدوثها، بدلًا من الاستطلاع.
ما هي الخدمات المدعومة عبر واجهة برمجة التطبيقات؟
أكثر من 80 خدمة بما في ذلك WhatsApp وTelegram وGoogle وInstagram وFacebook وDiscord والمزيد. استدعِ GET /otp-catalog للحصول على القائمة الحية.
ابدأ في إعادة بيع أرقام OTP اليوم
أنشئ حسابًا مجانيًا، وأنشئ مفتاح API الخاص بك، ووفّر رقم OTP الأول الخاص بك خلال دقائق.