Dev DOC - SMSMobileAPI
توثيق مطور SMSmobileAPI يمكنك إرسال رسائل WhatsApp فقط من خلال واجهة برمجة التطبيقات الخاصة بنا. انقر هنا لمعرفة المزيد.

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

لدينا أيضًا مكونات إضافية جاهزة للاستخدام لحلول وبرامج التجارة الإلكترونية. انقر هنا لاكتشافهم.

إذا كان لديك أي أسئلة أو اقتراحات أو تحتاج إلى مساعدة، فإن فريقنا هنا لمساعدتك.
لا تتردد في التواصل معنا على api@smsmobileapi.com

.
واجهة برمجة التطبيقات REST
cURL
جافا سكريبت جافا سكريبت
بايثون بايثون
نود.جي اس نود.جي اس
روبي روبي
WSDL

إرسال الرسائل القصيرة و WhatsApp API

تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.

1. مصادقة مفتاح API لإرسال الرسائل القصيرة

تتطلب هذه الطريقة مفتاح API يمكن تضمينه كمعلمة في طلب GET أو POST. إنها طريقة مباشرة للتحقق من صحة طلبات API الخاصة بك.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

حدود:

- apikey:مفتاح API الفريد الخاص بك.
- recipients:رقم هاتف المستلم.
- message:الرسالة المراد إرسالها (طول الرسالة غير محدود بـ 160 حرفًا؛ يمكنك إرسال رسائل أطول)
- sendwa:1=يجب إرسال الرسالة عبر WhatsApp.
- sendsms:1 = يجب إرسال الرسالة عبر رسالة نصية قصيرة تقليدية. (إذا يرسل رسالة نصية قصيرة فارغ: تم إرساله افتراضيًا، تم ضبطه على 0 لحظر الرسائل القصيرة)
- schedule_timestamp = يمثل الوقت الذي يجب إرسال الرسالة النصية القصيرة منه - يجب أن يكون **طابع زمني UNIX (GMT 0)**

مثال:

احصل على https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
ملاحظة: في حالة حدوث خطأ في التسليم بسبب مشغل الشبكة الخاص بك، تحاول وظيفة افتراضية إعادة إرسال نفس الرسالة النصية القصيرة ما يصل إلى 3 مرات ضمن فترة زمنية محددة.

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 لتعزيز الأمان وقابلية التوسع في عمليات التكامل الخاصة بك.

لمزيد من التفاصيل، يرجى الرجوع إلى الوثائق الكاملة.


إعادة إرسال رسالة نصية قصيرة غير مرسلة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإعادة إرسال رسالة نصية قصيرة غير مرسلة (فقط إذا كانت الرسالة تحتوي على حالة خطأ)

https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY

المعلمة:

- guid: (مطلوب) GUID للرسالة التي سيتم إعادة إرسالها.


سجل الرسائل النصية القصيرة المرسلة من واجهة برمجة التطبيقات

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد سجل رسائل SMS المرسلة عبر واجهة برمجة التطبيقات.

https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

المعلمة:

- apikey: (مطلوب) مفتاح API الخاص بك.
- guid_message: مختصر بواسطة المعرف الفريد للرسالة المستخدمة للفرز والتصفية.
- before: استرداد الرسائل المرسلة قبل هذا الطابع الزمني أو GUID المحدد.
- error_api: أدخل `1` (`&error_api=1`) لإدراج جميع الرسائل النصية القصيرة التي واجهت خطأً أثناء طلب واجهة برمجة التطبيقات.
- error_mobile: أدخل `1` (`&error_mobile=1`) لإدراج جميع الرسائل النصية القصيرة التي واجهت خطأ أثناء معالجة الهاتف المحمول.
- keyword: كلمة رئيسية لتصفية الرسائل بناءً على رقم المستلم أو محتوى الرسالة النصية القصيرة.



احصل على الرسائل النصية القصيرة المستلمة على واجهة برمجة التطبيقات المحمولة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد رسائل SMS المستلمة على الهاتف الذكي.

https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

المعلمة:

- apikey: مفتاح API الذي لديك أو سوف تتلقاه.
.


Webhook – الرسائل القصيرة المستلمة

يرسل نظام webhook هذا طلب POST إلى عنوان URL المُهيأ كلما تم استلام رسالة نصية قصيرة. ويضمن النظام التحديثات في الوقت الفعلي من خلال تسليم تفاصيل الرسائل النصية القصيرة إلى عنوان URL الخاص بـ webhook المحدد.

كيفية تكوين Webhook في لوحة المعلومات

اتبع الخطوات التالية لإعداد عنوان URL الخاص بـ webhook في لوحة المعلومات:

  1. قم بتسجيل الدخول إلى حسابك على لوحة معلومات واجهة برمجة تطبيقات SMS Mobile.
  2. انتقل إلى إعدادات الويب هوك قسم.
  3. أدخل عنوان URL لخطاف الويب الخاص بك (على سبيل المثال، https://example.com/webhook-endpoint
  4. انقر على حفظ Webhook زر.
  5. بمجرد الحفظ، سيبدأ النظام في إرسال تفاصيل الرسائل القصيرة إلى عنوان 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

https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

المعلمة:

- apikey: مفتاح API الذي لديك.
- guid_message: المعرف الفريد للرسالة التي يجب حذفها.
- date_start: إذا تم استخدامه بمفرده، فسيتم حذف جميع الرسائل من اليوم المحدد.
- date_start and date_end: مشترك لحذف الرسائل خلال فترة زمنية محددة.

ملاحظة: الرسائل النصية القصيرة المحذوفة هي فقط تلك المخزنة في سجلات حساب تطبيق الهاتف المحمول الخاص بك. لن يتم حذف الرسائل النصية القصيرة الموجودة على الجهاز المحمول نفسه، حيث لا يمكننا الوصول إليها.

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

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


الأسئلة الشائعة للمطورين

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

ابدأ مع SMSmobileAPI اليوم!

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

تنزيل التطبيق
ربط هاتفي المحمول