خدمة الـ API

خدمة الـ API :
هى ملف برمجة يمكنك من استخدام حسابك لديك في الارسال عن طريقها من موقعك .
مثلا : موقعك موقع تسوق ترغب في ان تصل لاعضاؤك رسالة قصيرة بعد عملية الدفع ، فيمكنك عن طريق الملف البرمجي دمجه مع موقعك بحيث يمكنك استخدام رصيدك لارسال تلك الرسائل .

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

كيفية استخدام ال API :
رابط الارسال :-
http://b4sms.com/sendsms.php?user=demo&password=demo&numbers=966540000000&sender=test.com&message=test&lang=en
قائمة المتغيرات المستخدمة :-

اسم المتغير	قيمة المتغير
user	نقوم بالتعويض عنها باسم المستخدم
password	نقوم بالتعويض عنها بكلمة المرور
numbers	نقوم بالتعويض عنها برقم جوال المرسل اليه , يمكنك الارسال الى أكثر من رقم وذلك بوضع فاصلة (,) بين الأرقام
sender	قوم بالتعويض عنها باسم المرسل
message	نقوم بالتعويض عنها بالرسالة المراد إرسالها
lang	نقوم بالتعويض عنها بلغة الرسالة , القيم المتاحة : ar,en

مجموعة القيم الناتجه من تنفيذ رابط الإرسال , ومعنى كل منها :-

ناتج الارسال	ما يعنيه الناتج
1	تم الإرسال بنجاح
0	خطأ في الإرسال
Invalid login	خطأ في بيانات الدخول
Missing or Empty Field	توجد قيمة خاطئة في إحدى الحقول , أو هناك حقل فارغ
Insufficent Balance	رصيدك لايكفي لإتمام عملية الإرسال
Invalid Sender	خطأ في اسم المرسل , اسم المرسل لابد أن يتكون من حروف انجليزية وأرقام
Sender name is not activated	اسم المرسل غير مفعل
Invalid Message Language	لغة الرسالة مخالفة عن القيمة المذكورة في متغير Lang

رابط جلب الرصيد : يمكنك عن طريق الرابط التالي معرفة رصيدك دون الحاجة إلى الدخول إلى الموقع
http://b4sms.com/sendsms.php?user=demo&password=demo&action=get

ملاحظه : تخصم النقاط بناء على طول الرسالة المرسلة وفيما يلي بيان لكيفية حساب تكلفة الرسالة :-
- الرسالة إنجليزية : اذا كان طول الرسالة 160 حرف أو أقل يتم احتسابها بنقطة واحدة , أما إذا كان طول الرسالة أكثر من ذلك يتم احتساب كل 153 حرف بنقطة.
- الرسالة عربية : اذا كان طول الرسالة 70 حرف أو أقل يتم احتسابها بنقطة واحدة , أما إذا كان طول الرسالة أكثر من ذلك يتم احتساب كل 67 حرف بنقطة.

---