الأسئلة المتكررة


بوابة العبور API


1 - ماهي بوابة العبور SMS API

2 - طريقة عمل الـ API

3 - لماذا احتاج الـ API

4 - كيف احصل على الـ API

5 - التعامل مع ترميز المحارف UTF-8 للغة العربية

ماهي بوابة العبور SMS API
بوابة العبور SMS API (بالإنجليزية: Application Programming Interface وتختصر إلى API) هي واجهة برمجية تتيح للمطورين الربط بين برامجهم وخدمة الرسائل النصية القصيرة SMS وذلك من خلال تنفيذ أوامر إرسال الإشعارات أو التذكير عبر الرسائل النصية بشكل مباشر دون الحاجةللدخول إلى موقع الخدمة.

طريقة عمل الـ API
الآن بإمكان المبرمجين و المطورين تكييف برامجهم و تطويعها ليتم الإرسال بها من خلال بوابة العبور لدينا . تم إعداد هذه البوابة لتكون مناسبة و مرنة للجميع .

يتكون ال API الخاص sms40.com من دالتين اساسية:

1- دالة للحصول على الرصيد

2- دالة للإرسال

كما ان هناك عدد من الدوال الأخرى ومنها دالة تحويل البيانات إلى تشفير الآسكي قبل ارسالها لنا حتى تصلنا الرسالة بكامل محتواها دون انقطاع أو تلف ومن ثم يقوم النظام بالإرسال من خلال البوابة وفوترة الرسالة من حساب المستخدم..

لماذا احتاج الـ API
إذا كنت تملك أي تطبيق مبرمج بأي لغة أو كنت مبرمج وتنوي إنشاء تطبيق يعتمد إرسال الرسائل للجوال فبإمكانك الاتصال ببوابة العبور لدينا عن طريق المثال الموجود على الموقع أو تطوير الدوال الخاصة بك والتي يجب أن تقوم بنفس المهمة لتصل رسالتك لبوابة العبور.

كيف احصل على الـ API
بمجرد الإشتراك في الخدمة يتم تفعيل الوصول إلى بوابة العبور SMS API بشكل آلي ..

كل ماتحتاجه هو معلومات الدخول إلى حسابك دينا ليتم الارسال من خلال البوابة بأي لغة برمجية كانت سواء PHP. ASP.#C .. الخ

قم بإستخدام اسم المستخدم و كلمة المرور التي قمت بالتسجيل بها من خلال موقعنا لتتم عملية الربط بشكل سليم .


فيما يلي طريقة الربط مع بوابة إرسال رسائل sms40.com



1- رابط إرسال رسالة أو عدة رسائل

http://my.sms40.com/api.php?username=XXXX&amppassword=XXXX&amptype=SendSMS&ampsender=XXXX&ampmobile=96600000000&ampmessage=XXXX


----------------------------------------------------------------------------------------
username = اسم المستخدم الخاص بحسابك
password =كلمة المرور الخاصة بالحساب
sender = اسم المرسل الذي سيظهر في الرسالة
mobile = رقم الهاتف الجوال (بالكود الدولي)
message = الرسالة
----------------------------------------------------------------------------------------


نتائج تنفيذ الأمر

----------------------------------------------------------------------------------------
OK = تم الإرسال بنجاح

ERROR BALANCE IS LOW = الرصيد لايغطي تكلفة الإرسال

Missing Fields = هناك حقول فارغة مثل اسم المرسل او رقم الجوال او الرسالة

ERROR USER OR PASS = خطأ في اسم المستخدم أو كلمة المرور
----------------------------------------------------------------------------------------


2- رابط معرفة الرصيد

http://my.sms40.com/api.php?username=XXXX&amppassword=XXXX&amptype=GetBalance

----------------------------------------------------------------------------------------
username = اسم المستخدم الخاص بحسابك
password =كلمة المرور الخاصة بالحساب
----------------------------------------------------------------------------------------

سيتم إظهار عدد الرسائل المتوفرة في الحساب

التعامل مع ترميز المحارف UTF-8 للغة العربية
في حال ظهور نص الرسالة باللغة العربية برموز غير مفهومة إستخدم دالة الرابط api2 للتعامل مع الترميز UTF-8 :


http://my.sms40.com/api2.php?username=XXXX&amppassword=XXXX&amptype=SendSMS&ampsender=XXXX&ampmobile=96600000000&ampmessage=XXXX