في SMSmobileAPI، نسعى جاهدين لجعل واجهة برمجة التطبيقات الخاصة بنا متوافقة قدر الإمكان مع أي بنية أو منصة.
سواء كنت تستخدم REST أو SOAP أو cURL أو لغات برمجة مختلفة مثل Python أو JavaScript أو PHP والمزيد، فإن واجهة برمجة التطبيقات الخاصة بنا مصممة للتكامل بسلاسة في مشاريعك.
لدينا أيضًا مكونات إضافية جاهزة للاستخدام لحلول وبرامج التجارة الإلكترونية. انقر هنا لاكتشافهم.
إذا كان لديك أي أسئلة أو اقتراحات أو تحتاج إلى مساعدة، فإن فريقنا هنا لمساعدتك.
لا تتردد في التواصل معنا على api@smsmobileapi.com

إرسال الرسائل القصيرة و WhatsApp API
تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.
1. مصادقة مفتاح API لإرسال الرسائل القصيرة
تتطلب هذه الطريقة مفتاح API يمكن تضمينه كمعلمة في طلب GET أو POST. إنها طريقة مباشرة للتحقق من صحة طلبات API الخاصة بك.
حدود:
مثال:
احصل على https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
2. مصادقة OAuth2 لإرسال الرسائل القصيرة
يوفر OAuth2 طريقة مصادقة أكثر أمانًا وقابلة للتطوير.
سوف تحتاج إلى استخدام معرف العميل وسر العميل للحصول على رمز وصول، والذي يجب تضمينه بعد ذلك في طلبات واجهة برمجة التطبيقات الخاصة بك باستخدام التفويض رأس الصفحة.
قم بتنزيل التطبيق المحمول الآن أو الوصول إلى لوحة التحكم الخاصة بك.
الحصول على رمز الوصول
للحصول على رمز وصول، أرسل طلب POST إلى نقطة نهاية الرمز باستخدام معرف العميل والسر الخاص بالعميل.
curl -X POST https://api.smsmobileapi.com/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"
استخدام رمز الوصول:
بمجرد حصولك على رمز الوصول، قم بتضمينه في التفويض رأس طلبات واجهة برمجة التطبيقات الخاصة بك:
curl -X POST https://api.smsmobileapi.com/sendsms \
-H "التفويض: الناقل abc123xyz456" \
-H "نوع المحتوى: application/x-www-form-urlencoded" \
-d "المستلمون=+1234567890" \
-d "الرسالة=مرحبا"
ما هي الطريقة التي يجب عليك استخدامها؟
- يستخدم مصادقة مفتاح API للتكامل السريع والمباشر.
- يستخدم مصادقة OAuth2 لتعزيز الأمان وقابلية التوسع في عمليات التكامل الخاصة بك.
لمزيد من التفاصيل، يرجى الرجوع إلى الوثائق الكاملة.
إعادة إرسال رسالة نصية قصيرة غير مرسلة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإعادة إرسال رسالة نصية قصيرة غير مرسلة (فقط إذا كانت الرسالة تحتوي على حالة خطأ)
المعلمة:
سجل الرسائل النصية القصيرة المرسلة من واجهة برمجة التطبيقات
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد سجل رسائل SMS المرسلة عبر واجهة برمجة التطبيقات.
المعلمة:
احصل على الرسائل النصية القصيرة المستلمة على واجهة برمجة التطبيقات المحمولة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد رسائل SMS المستلمة على الهاتف الذكي.
المعلمة:
Webhook – الرسائل القصيرة المستلمة
يرسل نظام webhook هذا طلب POST إلى عنوان URL المُهيأ كلما تم استلام رسالة نصية قصيرة. ويضمن النظام التحديثات في الوقت الفعلي من خلال تسليم تفاصيل الرسائل النصية القصيرة إلى عنوان URL الخاص بـ webhook المحدد.
كيفية تكوين Webhook في لوحة المعلومات
اتبع الخطوات التالية لإعداد عنوان URL الخاص بـ webhook في لوحة المعلومات:
- قم بتسجيل الدخول إلى حسابك على لوحة معلومات واجهة برمجة تطبيقات SMS Mobile.
- انتقل إلى إعدادات الويب هوك قسم.
- أدخل عنوان URL لخطاف الويب الخاص بك (على سبيل المثال،
https://example.com/webhook-endpoint
- انقر على حفظ Webhook زر.
- بمجرد الحفظ، سيبدأ النظام في إرسال تفاصيل الرسائل القصيرة إلى عنوان URL الذي تم تكوينه.
حمولة الويب هوك
عند استلام رسالة نصية قصيرة، يرسل النظام الحمولة JSON التالية إلى عنوان URL الخاص بـ webhook الخاص بك:
{
"التاريخ": "2025-01-20"،
"الساعة": "10:15:00"،
"الوقت المستلم": "2025-01-20 10:14:50"،
"message": "مرحبًا، هذا اختبار."
"الرقم": "+123456789"،
"الدليل": "abcde12345"
}
حقول الحمولة:
- تاريخ: التاريخ الذي تمت فيه إضافة الرسائل القصيرة (YYYY-MM-DD).
- ساعة: الساعة التي تمت فيها إضافة الرسالة النصية القصيرة (ساعة:دقيقة:ثانية).
- الوقت المستلم: الوقت الذي تم فيه استلام الرسالة النصية القصيرة.
- رسالة: محتوى الرسالة النصية القصيرة.
- رقم: رقم هاتف المرسل.
- الدليل: معرف فريد للرسالة القصيرة.
مثال على نقطة نهاية Webhook
يجب أن يكون الخادم جاهزًا للتعامل مع طلبات POST الواردة. فيما يلي مثال لنص PHP لمعالجة حمولة webhook:
<?php
// قراءة الحمولة الواردة
$payload = file_get_contents('php://input');
$data = json_decode($payload، صحيح)؛
// معالجة بيانات الرسائل القصيرة
إذا ($data) {
// مثال: قم بتسجيل بيانات الرسائل القصيرة في ملف
ملف_put_contents('sms_log.txt', print_r($data، صحيح)، FILE_APPEND);
// الرد بحالة HTTP 200
http_response_code(200);
echo "تم استلام Webhook بنجاح.";
} آخر {
// الرد بحالة HTTP 400 للطلبات السيئة
http_response_code(400);
echo "حمولة غير صالحة.";
}
?>
اختبار Webhook
لاختبار تكوين خطاف الويب الخاص بك، استخدم أدوات مثل:
تتيح لك هذه الأدوات فحص الحمولة المرسلة بواسطة النظام واستكشاف أي مشكلات تتعلق بإعداد خطاف الويب الخاص بك وإصلاحها.
استكشاف الأخطاء وإصلاحها
- تأكد من أن عنوان URL الخاص بـ webhook صحيح ويمكن الوصول إليه علنًا.
- تأكد من أن الخادم الخاص بك يقوم بإرجاع رمز الحالة HTTP 200 للطلبات الناجحة.
- تحقق من سجلات الخادم لديك بحثًا عن أي أخطاء في معالجة الحمولة.
حذف واجهة برمجة تطبيقات الرسائل القصيرة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لحذف رسائل SMS من سجل خادم SMS Mobile API
المعلمة:
ملاحظة: الرسائل النصية القصيرة المحذوفة هي فقط تلك المخزنة في سجلات حساب تطبيق الهاتف المحمول الخاص بك. لن يتم حذف الرسائل النصية القصيرة الموجودة على الجهاز المحمول نفسه، حيث لا يمكننا الوصول إليها.

تنشأ هذه المشكلة من عملية تحاول التشغيل في الخلفية عندما لا يتم تشغيل التطبيق بشكل نشط. ومع ذلك، نظرًا لإجراءات تحسين البطارية في Android، والتي تختلف عبر الإصدارات المختلفة، فقد لا يتم تشغيل هذه العملية في الخلفية بشكل صحيح. تم تصميم تحسين البطارية في Android للحد من نشاط التطبيقات في الخلفية للحفاظ على عمر البطارية، وهو ما قد يؤثر عن غير قصد على التطبيقات التي تتطلب عمليات خلفية للعمل بشكل صحيح.
ولمعالجة هذه المشكلة، يمكن للمستخدمين تكوين إعدادات Android يدويًا للسماح لـ SmsMobileApi باستخدام الموارد دون قيود.
يتضمن هذا ضبط إعدادات تحسين البطارية للتطبيق المحدد، مما يعني في الأساس إعطاء تعليمات إلى Android بأن SmsMobileApi مسموح له بالعمل في الخلفية واستخدام الموارد حسب الحاجة. ومن خلال القيام بذلك، يجب أن يكون التطبيق قادرًا على إرسال واستقبال رسائل SMS تلقائيًا حتى عندما لا يكون التطبيق النشط في المقدمة. يضمن هذا التعديل أن العملية الضرورية في الخلفية يمكن أن تعمل دون انقطاع، مما يتجنب ميزات تحسين البطارية التي قد تمنع تنفيذها بشكل صحيح.


الأسئلة الشائعة للمطورين
ابدأ مع SMSmobileAPI اليوم!
استمتع بالحرية والمرونة في إدارة خدمات الرسائل القصيرة الخاصة بك أثناء التنقل. قم بتنزيل تطبيقنا المحمول الآن واتخذ الخطوة الأولى نحو التكامل السلس للرسائل القصيرة.
تنزيل التطبيق