حلول برمجية
تفعيل الارسال من API
نوفر لكم إمكانية ربط خدمة الرسائل النصية القصيرة في تطبيقك (API) ويمكنكم الإطلاع أدناه على شروحات تساعدكم على البدء في الربط مع التطبيق الخاص بك في عضون دقائق
اولا : حرصا على تمكينكم من الإرسال عن طريق خدمة ال API بشكل امن وإلتزاما بقوانين هيئة الإتصالات والفضاء والتقنية فنرجو منكم توليد bearerTokens و تسجيل ال ip الخاص بكم في القائمة البيضاء حيث سيتم رفض الرسائل التي سيتم إرسالها من خلال IP غير مسجل في القوائم البيضاء يمكنك الإطلاع من خلال الرابط على شرح مفصل لطريقة توليد ال bearerTokens وتسجيل ال IP في القائمة البيضاء
ثانيا: نقدم حلول للربط مع مجموعة انظمة جاهزة مثل نظام نور , ومنصة سلة و منصة دفترة وهنالك المزيد قيد الربط لتوسيع تواصلنا ومساعدة المبرمجين لإنجاز مهامهم بسهولة , وللإطلاع على حلول الربط المتوفرة
https://dev.taqnyat.sa/ar/integration/ثالثا: للإطلاع على شروحات واجهات برمجة التطبيقات ( API )
https://dev.taqnyat.sa/en/doc/sms/رابعا: يتوفر امثلة برمجية تساعدكم في إتمام عملية الربط عن طريق ال API
ملاحظة : ملاحظة هامة : في حال وجود مشكلة في تكرار عملية الإرسال من خلال التطبيق الخاص بكم فاننا نوفر دالة جاهزة لمنع استقبال الرسائل المكررة خلال 15 دقيقة من البوابة الخاصة بنا ويمكنكم إستخدامها وإضافتها لدالة الإرسال والدالة هي smsId=0
إنشاء حامل توكين Bearer token
لإستخدام واجهة برمجة التطبيقات (API) الخاصة بنا، ستحتاج إلى رمز الحامل Bearer token ويتم إنشاؤه من حسابك على موقعنا باتباع الخطوات التالية
- قم بالدخول لحسابك في موقعنا عبر الرابط https://portal.taqnyat.sa/
- اختر " المطورين "
- اختر التطبيقات
- قم بالضغط على علامة + لانشاء رمز الحامل Bearer token
- ادخل اسم الموقع الخاص بك في خانة اسم التطبيق
- فعل المنتج SMS
- اضغط على علامة الصح لاتمام العملية
صورة توضيحية :
اضافة عنوان الخادم على القائمة البيضاء
لاضافة عنوان الخادم اي بي IP على القائمة البيضاء , يرجى اتباع الخطوات التالية :
- قم بالدخول لحسابك عبر الرابط https://portal.taqnyat.sa/
- اختر الاعدادت الأمنية
- اضافة على علامة + لاضافة عنوان الخادم اي بي IP جديد على القائمة البيضاء
- في خانة " الاسم " ادخل اسم افتراضي لبروتوكول الانترنت اي بي IP
- في خانة " عنوان الخادم " ادخل الاي بي IP
- فعل الحالة الى " مصرح له "
- اضغط على علامة الصح
- ادخل رمز التحقق الثنائي الذي يتم ارساله للجوال المعتمد لتأكيد العملية
في حال الإرسال عن طريق ال API من خلال عنوان خادم اي بي IP غير مسجل فسيتم ارسال تنبيه لكم على الإيميل المعتمد و فسيتم اضافة عنوان الخادم الاي بي IP تلقائيا على قائمة الإعدادات الأمنية بالحالة " غير مصرح " ويمكنك فقط تفعيل الإرسال من خلاله عن طريق تغيير الحالة الى " مصرح به "
صورة توضيحية :
الاعدادت الامنية
للحرص على امان حسابكم والتزاما بأنظمة وقوانين هيئة الإتصالات فاننا نوفر عن طريق خدمة الاعدادات الامنية التحكم بإمكانية الوصول لحسابك و تحديد عنوان الخادم ال IP المسموح لها الوصول لحسابك .
- تعطيل الارسال باستخدام بوابات الارسال ; يمكنك منع او السماح بربط حسابك عن طريق خدمة ال API لن يتم السماح بربط حسابك عن طريق ال API في حال تفعيل تعطيل الإرسال باستخدام بوابات الإرسال
- تفعيل الارسال من عنوان اي بي محدد ; للسماح بالوصول الى حسابك فانه يتوجب اضافة عنوان الخادم ال IP على القائمة البيضاء , حيث سيتم رفض الوصول لحسابك في حال محاولة الوصول من خلال اي بي IP غير مضاف على القائمة البيضاء
صورة توضيحية :
الويب هوك
خدمة الويب هوك webhook تتيح لكم استقبال تقرير الوصول على الموقع الخاص بكم
يمكنكم الإطلاع على شرح مفصل للطريقة من الرابط ادناه :
في خانة رابط الويب , يتم اضافة عنوان الويب الذي ترغب باستقبال تقرير الوصول عليه عبارة تأكيد استلام الويب هوك , هي العبارة التي يتم تحديدها من خلالكم في البرنامج الخاص بكم ويتم اعادتها لنا كنتيجة عند تأكيد استقبال تقرير الوصول من طرفكم
صورة توضيحية :
إيقاف مفاتيح الارسال
ميزة " اعدادات ايقاف مفاتيح الارسال " تتعلق بعمليات الارسال التي تتم من خلال ال API , و يمكنك الحصول على رسالة نصية عند وصول قيمة الرسائل المرسلة من حسابك خلال 5 دقائق لحد معين وايضا ايقاف مفاتيح الارسال , حيث يتيح لك هذا الخيار التاكد من ان عمليات الإرسال تتم من حسابك بشكل طبيعي
ولتفعيل الميزة يرجى اتباع الخطوات التالية :
- قم بالدخول لحسابك في موقعنا عبر الرابط https://portal.taqnyat.sa/
- اختر الاعدادات
- اختر اعدادات الحساب
- في خيار " اعدادات ايقاف مفاتيح الارسال " حدد المبلغ اللذي سيتم اعتماده لارسال رساله عند وصول قيمه الارسال خلال 5 دقائق الي القيمه المحدده وايقاف مفاتيح الارسال
- حدد الرقم الذي سيتم ارسال رسالة التنبيه عليه وابلاغك من خلاله بايقاف مفاتيح الارسال
صورة توضيحية :
