واجهة برمجة التحقق عبر SMS للمطورين: البداية

إذا كنت تختبر مسار التسجيل في تطبيقك أو تُؤتمت عملية التحقق، فإن الواجهة البرمجية تتيح لك القيام بكل ما تقوم به لوحة التحكم دون الحاجة إلى فتحها.

قبل أن تبدأ

احصل على مفتاحك من صفحة API في لوحة التحكم. لا ترفع المفتاح إلى مستودع الشيفرة البرمجية؛ احفظه في متغير بيئة.

الخطوات الأساسية

1. اجلب قائمة الخدمات والدول.
2. اشترِ رقماً.
3. تحقق من الحالة على فترات زمنية، أو استخدم webhook.
4. أكمل التفعيل عند وصول الرمز، وألغِه إذا لم يصل.

أمور يجب مراعاتها

• عند إعادة المحاولة، أرسل ترويسة Idempotency-Key. إذا أعدت المحاولة بالمفتاح نفسه بعد خطأ في الشبكة، فلن يُشترى رقم ثانٍ.
• احترم حد الطلبات (rate limit)، ولا تقصّر فترة الاستعلام دون داعٍ.
• تعامل مع ردّي الرصيد غير الكافي ونفاد المخزون بشكل منفصل في شيفرتك.

إذا كان برنامجك يستخدم بروتوكول SMS-Activate المتوافق، فيمكنك الاتصال عبر نقاط النهاية المتوافقة دون تغيير شيفرتك. كل التفاصيل موجودة في توثيق الواجهة البرمجية.