واجهة برمجة تطبيقات الرقم الافتراضي
للموزعين
قم بتزويد أرقام هواتف افتراضية مخصصة شهريًا وسنويًا برمجيًا، حدد سعر إعادة البيع الخاص بك، وابنِ علامتك التجارية للتحقق من الرسائل القصيرة — دون امتلاك شريحة SIM واحدة.
لماذا تبني على واجهة برمجة تطبيقات VRNUM بدلاً من صفقات الناقل الخاصة بك
الحصول على أرقام الناقلين المحمولين الحقيقية مباشرة يعني عقود شرائح SIM، الأجهزة، أعباء الامتثال، وشهور من الوقت قبل أن تتمكن من بيع أي تحقق واحد. تتجاوز واجهة برمجة تطبيقات VRNUM كل ذلك.
تحصل على وصول فوري إلى مخزون حي من الأرقام الافتراضية الشهرية والسنوية عبر أكثر من 50 دولة، مع هامشك الخاص مضمن في كل سعر تُرجعه الواجهة. عملاؤك يرون دائمًا علامتك التجارية وسعرك فقط.
من مفتاح الواجهة إلى أول عملية بيع لك
أربع خطوات لتكامل موزع يعمل.
إنشاء مفتاح API
قم بإنشاء حساب VRNUM مجاني وقم بإنشاء مفتاح من تبويب المطورين. مفتاح نشط واحد لكل حساب.
تمويل محفظتك
قم بإضافة رصيد باستخدام العملات المشفرة. يتم خصم كل طلب من رصيدك — لا فواتير، لا فوترة يدوية.
قراءة الكتالوج
اتصل بـ GET /catalog للحصول على الدول المتاحة، شروط الاشتراك، والأسعار مباشرة. أضف هامشك قبل عرضها.
التزويد عند الطلب
POST /numbers باستخدام Idempotency-Key لتعيين رقم على الفور، ثم استخدم الاستطلاع أو الويب هوكس للتسليم.
تزويد رقم في طلب واحد
clientReference هو معرفك الغامض الخاص — أرفقه لمطابقة الطلبات مع سجلات عملائك الداخلية.
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"
}'كل ما تحتاجه لتشغيل دورة حياة الطلب بالكامل
الكتالوج، التزويد، استرجاع الرسائل النصية، التجديد، التجديد التلقائي، وwebhooks — واجهة API واحدة متسقة بصيغة JSON.
/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/balanceوثائق الطلب/الاستجابة الكاملة ومفاتيحك موجودة فيلوحة التحكمبعد تسجيل الدخول.
من يبني على واجهة برمجة تطبيقات الأرقام الافتراضية
أي عمل يحتاج إلى توفير أرقام هاتف حقيقية بدون امتلاك بنية تحتية للاتصالات.
إعادة بيع خدمات الاتصالات
أطلق علامتك الخاصة للأرقام كخدمة استنادًا إلى مخزون مزود الخدمة المباشر دون أي عقد شريح.
مؤسسو SaaS والتطبيقات
أضف توفير أرقام الهواتف إلى عملية الانضمام أو التحقق في منتجك ببضع استدعاءات API.
وكالات التطوير
قم بشحن ميزات توفير الأرقام لتطبيقات العملاء دون التفاوض على اتفاقياتك الخاصة مع شركات الاتصالات.
فرق الاختبار وضمان الجودة والأتمتة
قم بتوفير أرقام حقيقية مؤقتة عند الطلب لمجموعات اختبارات التسجيل والتحقق الآلي.
مصمم للإنتاج، وليس للعرض التوضيحي
مفاتيح عدم التكرار
أعد المحاولة بأمان عند حدوث مهلة — نفس مفتاح عدم التكرار دائمًا يعيد الطلب الأصلي، ولا ينتج أبدًا نسخة مكررة.
ويب هوكس موقعة
أحداث number.provisioned و number.provisioning_failed و sms.received، موقعة باستخدام X-VRNUM-Signature (HMAC-SHA256).
إعادة المحاولات التلقائية
يتم إعادة محاولة تسليم webhook الفاشلة وفق جدول تدرجي (5 دقائق، 30 دقيقة، ساعتين، 6 ساعات، 24 ساعة) قبل أن نتوقف عن المحاولة.
حدود معدل الشفافة
60 طلبًا/دقيقة لكل مفتاح مع رؤوس X-RateLimit-* في كل استجابة، بحيث يمكنك التراجع عن الطلبات بشكل متوقع.
الفوترة باستخدام المحفظة
لا فواتير أو اشتراكات للوصول إلى API — يتم خصم الطلبات من رصيدك فور نجاحها.
رموز الأخطاء المستقرة
كل خطأ يُرجع رمز JSON موحد يمكن لتكامل النظام الخاص بك الاعتماد عليه، وليس مجرد حالة HTTP.
الأسئلة المتكررة
هل يمكنني إعادة بيع أرقام VRNUM الافتراضية تحت علامتي التجارية الخاصة؟
نعم. تُعيد واجهة برمجة التطبيقات سعر إعادة البيع الخاص بك فقط — عملاؤك لا يرون أبدًا تكلفة VRNUM الداخلية أو مصدر الناقل الأساسي. يمكنك تحديد هامشك الخاص لكل دولة وخدمة.
كيف يمكنني الحصول على الوصول إلى واجهة برمجة أرقام الهواتف الافتراضية؟
قم بإنشاء حساب VRNUM مجاني، وافتح علامة تبويب المطورين، وقم بإنشاء مفتاح API. لا حاجة للانتظار للموافقة، ولا رسوم شهرية للـ API — تدفع فقط من رصيد محفظتك عند تفعيل رقم.
ما نوع المصادقة التي تستخدمها واجهة برمجة التطبيقات؟
مصادقة Bearer token. أرسل مفتاح الـ API الخاص بك كعنوان Authorization: Bearer أو كعنوان X-API-Key في كل طلب.
هل هناك خطر من تكرار الطلبات إذا انتهى وقت الطلب؟
لا. كل نقطة نهاية لشراء الأرقام تقبل رأس Idempotency-Key — كرر نفس الطلب بنفس المفتاح وستحصل على الطلب الأصلي بدلاً من فرض رسوم مكررة.
كيف يمكنني الحصول على إشعارات عند جاهزية الرقم أو وصول رسالة SMS؟
سجل عنوان URL الخاص بالويبهوك من علامة تبويب المطورين. تقوم VRNUM بإرسال أحداث موقعة (number.provisioned, number.provisioning_failed, sms.received) إلى نقطة النهاية الخاصة بك، مع إعادة المحاولة تلقائيًا في حال فشل التسليم.
ما هي حدود معدل واجهة برمجة التطبيقات (API)؟
60 طلبًا لكل مفتاح في الدقيقة. كل رد يتضمن رؤوس X-RateLimit-Limit و X-RateLimit-Remaining و X-RateLimit-Reset حتى تتمكن من التراجع بسلاسة.
ابدأ بإعادة بيع الأرقام الافتراضية اليوم
أنشئ حسابًا مجانيًا، وولّد مفتاح API الخاص بك، وخصص أول رقم افتراضي لك في دقائق.