توثيق الرسائل القصيرة

إرسال رسالة نصية قصيرة

نقطة النهاية: 

حدود:

مثال على الطلب:

مثال على استجابة JSON:

{ "result": { "error": 0, "sent": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "note": "sent by mobile", "datetime": "2026-03-20T21:07:44Z", "datetimeLocal": "2026-03-20T22:07:44+01:00", "port": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "encrypted": { "status": "0" }, "trial_account": { "status": "0", "sms_sent": 0 } } }

شرح الرد:

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

تتيح لك هذه النقطة النهائية إعادة إرسال رسالة نصية قصيرة لم يتم إرسالها مسبقًا، فقط إذا كانت الرسالة حاليًا في حالة خطأ.

نقطة النهاية:

حدود: 

مثال على الطلب: 

مثال على استجابة JSON:

{ "result": { "error": "0", "sms": "تمت إعادة الإرسال بنجاح", "attempt": 1 } }

شرح الرد:

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

تتيح لك هذه النقطة النهائية استرداد سجل رسائل SMS المرسلة عبر واجهة برمجة التطبيقات (API).

نقطة النهاية: 

حدود:

مثال على الطلب:

مثال على استجابة JSON:

{ "result": { "error": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "port": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "timestamp": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_heure": "22:10:05", "send_from_mobile_timestamp": 1774044605, "recipients": "32495898697", "sms": "test", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

شرح الرد:

قائمة الرسائل النصية المرسلة من الهاتف المحمول

تتيح لك هذه النقطة النهائية عرض قائمة برسائل SMS المرسلة من جهازك المحمول والمتزامنة مع حساب SMSMobileAPI الخاص بك.

مهم: هذه الميزة متاحة بدءًا من إصدار Android 4.1.20.

مهم: هذه الميزة هي غير مفعل افتراضياً في تطبيق أندرويد.

خصوصية: جميع المعلومات المتزامنة مجهولة المصدر وسرية ويتم التعامل معها بشكل آمن.

الحد الأقصى للسجل: لا تُرجع واجهة برمجة التطبيقات هذه إلا البيانات من آخر إصدار. 7 أيام.

ملحوظة: إذا كنت ترسل رسائل نصية قصيرة باستخدام نقطة نهاية واجهة برمجة التطبيقات القياسية https://api.smsmobileapi.com/sendsms/قد تظهر هذه الرسائل النصية القصيرة أيضًا في هذه القائمة لأنها تُرسل فعليًا من جهازك المحمول.

نقطة النهاية:

حدود: 

الحقول المُعادة: 

مثال على الطلب: 

مثال مع المرشحات:

مثال بفترة زمنية محددة مسبقاً:

مثال على استجابة JSON:

{ "result": { "error": "0", "count": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "مرحباً، تم تأكيد موعدك.", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": { "+447700900123", "message": "رمز التحقق الخاص بك هو 482915.", "mobile_date_ms": 1774040902284, "mobile_date_formatted": "2026-03-20 22:08:22", "synchro_time": "2026-03-20 21:08:35" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+33198765432", "message": "نشكرك على طلبك. جارٍ معالجته الآن.", "mobile_date_ms": 1774026491230, "mobile_date_formatted": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

شرح الرد:

تم استلام الرسالة النصية القصيرة

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

نقطة النهاية:

حدود: 

مثال على الطلب:

مثال على استجابة JSON:

{ "result": { "error": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "message": "مرحباً، تم تسليم طردك.", "number": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341، "sIdentifiantPhone": "e5b70a8a28b2ec3d"، "date": "2026-03-20"، "hour": "21:23:34"، "timestamp_unix": 1774041814، "time_received": "20260320221005892"، "indice": "27591"، "message": "تم تأكيد موعدك غدًا."، "number": "+447700900123"، "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E"، "alias": null، "apikey": "YOUR_API_KEY_HASH" }، { "id": 466324، "sIdentifiantPhone": { "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "يرجى الاتصال بنا عند توفرنا.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "الساعة": "19:05:22", "الطابع الزمني يونكس": 1774033522, "وقت الاستلام": "20260320200026246", "الفهرس": "27588", "الرسالة": "تذكير: مراجعة حسابك قيد الانتظار.", "الرقم": "10001", "المعرف الفريد": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "الاسم المستعار": null, "مفتاح API": "YOUR_API_KEY_HASH" } ] } }

شرح الرد:

وضع علامة على رسائل SMS المستلمة كمقروءة

تُستخدم نقطة نهاية واجهة برمجة التطبيقات هذه لتمييز رسالة SMS واحدة مستلمة على أنها مقروءة. حالة واجهة برمجة التطبيقات فقط.
هذا لا يغير حالة القراءة على الهاتف الذكي.  

نقطة النهاية:

المعلمة: 

مثال:

تحديث اسم مستعار للرسائل النصية

تُستخدم نقطة نهاية واجهة برمجة التطبيقات هذه لتحديث اسم مستعار لرسالة نصية قصيرة مستلمة باستخدام معرّفها الفريد العالمي (GUID).

ملحوظة: ال alias يمكن أن تكون المعلمة فارغة. في هذه الحالة، سيتم مسح الاسم المستعار.

نقطة النهاية:

حدود: 

مثال: 

مثال لمسح الاسم المستعار:

حذف الرسائل النصية القصيرة

تتيح لك هذه النقطة النهائية حذف رسائل SMS من سجل خادم SMSMobileAPI.

نقطة النهاية: 

حدود:

مثال على الطلب:

مثال على استجابة JSON:

{ "result": { "error": null, "count_delete": 1 } }

شرح الرد:

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

قائمة محادثات الرسائل النصية القصيرة

تُستخدم نقطة نهاية واجهة برمجة التطبيقات هذه لعرض قائمة محادثات الرسائل النصية القصيرة المرتبطة بحسابك.

يتم تجميع كل محادثة حسب رقم الهاتف وتحتوي على رسائل SMS الواردة والصادرة ذات الصلة.

ملحوظة: تُحدد نقطة بدء المحادثة بواسطة origineConversation المعلمة:

• receivedيتم اكتشاف المحادثات أولاً من الرسائل النصية القصيرة الواردة في logsmsreceive
• sentيتم اكتشاف المحادثات أولاً من الرسائل النصية القصيرة المرسلة في logsmssent

ملحوظة: لو numero في حال عدم توفيرها، تُعيد واجهة برمجة التطبيقات (API) أحدث المحادثات فقط. بشكل افتراضي، تُعرض آخر المحادثات فقط. 20 يتم الرد على المحادثات.

ملحوظة: بالنسبة للرسائل النصية الصادرة، إذا timearea_of_message متاح (مثال: UTC+02يتم تحويل التاريخ المعروض تلقائيًا باستخدام هذه القيمة. ويُستخدم هذا التاريخ المُحوّل أيضًا في عملية الفرز.

ملحوظة: لو resume=1يتم عرض أحدث الرسائل فقط من كل محادثة. استخدم resume_line_how لتحديد عدد الرسائل الأخيرة التي يجب تضمينها.

نقطة النهاية:

حدود: 

تفاصيل السلوك: 

مثال 1 - عرض آخر المحادثات الواردة من الرسائل النصية القصيرة: 

مثال 2 - عرض آخر المحادثات من الرسائل النصية القصيرة المرسلة:

مثال 3 - تصفية رقم هاتف محدد:

مثال 4 - التصفية حسب نطاق التاريخ:

مثال 5 - وضع الاستئناف مع آخر 3 رسائل لكل محادثة:

مثال على استجابة ناجحة: 

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hello, I would like more information.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "بالتأكيد، ماذا تريد أن تعرف؟", "status": "sent", "mobile_sid": "device_sid_2" } ] } ] }

حقول الاستجابة:

مثال على الخطأ:

{ "success": false, "error": "المعامل المطلوب مفقود: apikey" }

ملحوظات:

البوابة - قائمة الهواتف المحمولة المتصلة

قائمة الهواتف المحمولة المتصلة بشبكتك بوابة الرسائل القصيرة.

نقطة النهاية:

حدود:

مثال:

بوابة - تحديث ملصق الهاتف المحمول

قم بتحديث التسمية (nom_reference) لجهاز جوال متصل.

نقطة النهاية:

حدود:

مثال:

مهم: الملصق مطلوب ولكن يمكن أن يكون فارغًا (label=).

البوابة - حذف جهاز جوال متصل

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

نقطة النهاية:

حدود:

مثال:

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 الخاص بك:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "مرحباً، هذه رسالة اختبار.", "number": "+123456789", "guid": "abcde12345" }

حقول الحمولة:

• تاريخ: التاريخ الذي تمت فيه إضافة الرسائل القصيرة (YYYY-MM-DD).
• ساعة: الساعة التي تمت فيها إضافة الرسالة النصية القصيرة (ساعة:دقيقة:ثانية).
• الوقت المستلم: الوقت الذي تم فيه استلام الرسالة النصية القصيرة.
• رسالة: محتوى الرسالة النصية القصيرة. 
• رقم: رقم هاتف المرسل.
• الدليل: معرف فريد للرسالة القصيرة.

مثال على نقطة نهاية Webhook

يجب أن يكون الخادم جاهزًا للتعامل مع طلبات POST الواردة. فيما يلي مثال لنص PHP لمعالجة حمولة webhook:

اختبار Webhook

لاختبار تكوين خطاف الويب الخاص بك، استخدم أدوات مثل:

• موقع ويب هوك
• طلب سلة

استكشاف الأخطاء وإصلاحها

• تأكد من أن عنوان URL الخاص بـ webhook صحيح ويمكن الوصول إليه علنًا.
• تأكد من أن الخادم الخاص بك يقوم بإرجاع رمز الحالة HTTP 200 للطلبات الناجحة.
• تحقق من سجلات الخادم لديك بحثًا عن أي أخطاء في معالجة الحمولة.

الرسائل النصية القصيرة المُحسّنة

المصادقة

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

1. مصادقة مفتاح API

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

2. مصادقة OAuth2

يوفر OAuth2 طريقة مصادقة أكثر أمانًا.
استخدم معرّف العميل وسر العميل للحصول على رمز الوصول، ثم قم بتضمينه في التفويض رأس الصفحة.

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

الحصول على رمز الوصول

استخدام رمز الوصول:

ما هي الطريقة التي يجب عليك استخدامها؟

- يستخدم مصادقة مفتاح API للتكامل السريع والمباشر.

- يستخدم مصادقة OAuth2 لتعزيز الأمان وقابلية التوسع.