واجهة API لإرسال الرسائل النصية
اربط تطبيقك بتوكيد من خادمك: طلب يرسل الرمز وطلب يتحقق منه، بمفتاح API واحد ودون برامج تثبّتها.
توكيد للتحقق واجهة API لرموز OTP في السعودية.0.09 ر.س لكل رمز SMS يُرسَل، والإرسال الذي ترفضه الشبكة يعود مبلغه إلى رصيدك فورًا.
أهم ما في الصفحة
طلبان وردّاهما
يرسل خادمك POST /v1/verify/start برقم الجوال فيعود 201 بمعرّف العملية، ثم POST /v1/verify/check بالمعرّف والرمز الذي كتبه المستخدم. وبالمعرّف تقرأ حالة العملية أو تعيد الإرسال أو تلغيها.
مصادقة بمفتاح API
مفتاح Bearer بادئته tk_live_، تنشئه من اللوحة ويُخزَّن مجزّأً على خوادمنا.
بيئة تجربة قبل الاعتماد
يرسل مفتاح tk_test_ رسائل حقيقية إلى جوال مالك الحساب بالطلب والرد نفسيهما، والإطلاق مجرد تبديل مفتاح.
توثيق بالعربية والإنجليزية
المرجع الكامل بالعربية في صفحة التوثيق: كل نقطة نهاية بمعاملاتها وردودها، وكل رموز الأخطاء، وأمثلة بعدة لغات برمجة.
كيفية إرسال رسائل SMS عبر الإنترنت من موقعك أو تطبيقك
تحتاج إلى حساب ومفتاح API فقط. أرسل الرمز من خادمك، ثم تحقق من الرمز الذي كتبه المستخدم.
أنشئ حسابك وأضف تطبيقك.
سجّل برقم جوال سعودي، ثم أضف اسم التطبيق ورابطه ليراجعهما شخص قبل الإرسال الفعلي.
أنشئ مفتاح API.
مفتاح tk_test_ للتجربة قبل الاعتماد، وtk_live_ بعده. احفظه في متغيرات البيئة على خادمك، لا في شيفرة المتصفح.
أرسل رمز التحقق.
أرسل POST /v1/verify/start من خادمك برقم المستخدم، فيعود إليك معرّف عملية التحقق.
تحقّق من الرمز.
أرسل المعرّف والرمز الذي كتبه المستخدم إلى POST /v1/verify/check، وأنشئ الجلسة في تطبيقك حين ينجح التحقق.
أسئلة شائعة
هل الواجهة REST أم SDK؟
واجهة REST API تستدعيها مباشرة من أي لغة برمجة، مع أمثلة جاهزة في التوثيق.
ما صيغة رقم الجوال في الطلب؟
يُقبل الرقم بخمس صيغ: 05… أو 5… أو 9665… أو +9665… أو 009665…، بأرقام مثل 123 أو ١٢٣، ويُحوَّل إلى +9665… قبل الإرسال.
هل يوجد رصيد للتجربة؟
نعم. 10 ر.س عند التسجيل بلا بطاقة، تجرّب بها المسار كاملًا قبل الشحن.
ما الأخطاء التي أعالجها أولًا؟
أهمها 422 invalid_destination لرقم غير سعودي، و402 insufficient_credits حين ينفد الرصيد، و429 rate_limited حين يتجاوز الرقم حده في الساعة، و403 account_not_active قبل اعتماد التطبيق. والقائمة الكاملة في المرجع.
هل أحتاج برنامجًا أو شريحة SIM؟
لا. ترسل عبر API من خادمك، دون برنامج تثبّته أو مودم أو شريحة.
هل أستطيع الإرسال من ووردبريس أو متجر إلكتروني؟
نعم. لمتاجر WooCommerce إضافة توكيد المجانية، وفيها الدخول بالجوال والتحقق قبل الدفع عند الاستلام. ولأي موقع آخر أرسل طلبات API من الخادم، حتى يبقى المفتاح سرًا.
أرسل أول رمز اليوم
سجّل برقم جوالك
يبدأ حسابك برصيد مجاني بقيمة {bonus} ر.س.
جرّب بمفتاح
tk_test_أنشئه من صفحة «مفاتيح API» قبل الاعتماد، فيرسل رسائل حقيقية تبدأ بعلامة [تجريبي] إلى الجوال الذي سجّلت به وحده، حتى 10 رسائل لكل تطبيق.
ضع
tk_live_مكانه بعد الاعتمادلا يتغير شيء آخر في الكود.