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

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

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

هل تحتاج إلى مساعدة؟ api@smsmobileapi.com

يبحث

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

تتيح لك هذه النقطة النهائية إرسال رسالة نصية قصيرة من هاتفك المحمول.

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

يحصل بريد https://api.smsmobileapi.com/sendsms/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الفريد الخاص بك.
recipients	مطلوب رقم هاتف المستلم.
message	مطلوب الرسالة المراد إرسالها (لا يوجد حد أقصى 160 حرفًا).
port	حدد منفذ شريحة SIM المراد استخدامه لإرسال الرسائل النصية القصيرة: 1, 2أو اتركه فارغاً. في حال ترك الحقل فارغاً، سيتم إرسال الرسائل النصية القصيرة تلقائياً باستخدام منفذ شريحة SIM المتاح. هذه الخاصية متاحة بدءًا من إصدار Android 4.1.15.0 ويعمل عندما يكون التطبيق في المقدمة (الخطة الأولى).
shorturl	1 = تحويل عناوين URL إلى روابط مختصرة صفر أو فارغ = لا يوجد تحويل
sIdentifiant	حدد الهاتف المتصل الذي سيرسل الرسالة النصية. اترك هذا الحقل فارغًا لاختيار أول جهاز متاح. يتطلب التطبيق الإصدار 3.0.35.3 أو أحدث.
sendwa	1 = إرسال عبر واتساب.
sendsms	1 = إرسال عبر الرسائل النصية (الوضع الافتراضي في حال كان الحقل فارغًا). اضبطه على 0 لحظر الرسائل النصية.
encrypt_message	نعم = يحتاج المستلم إلى مفتاح لفك التشفير. يتعلم أكثر
schedule_timestamp	الطابع الزمني لنظام يونكس (GMT 0) الذي يجب إرسال الرسالة النصية القصيرة منه.

مثال:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

ملاحظة: في حالة حدوث خطأ في التسليم بسبب المشغل الخاص بك، تقوم وظيفة افتراضية بإعادة المحاولة حتى 3 مرات.

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

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

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

يحصل بريد https://api.smsmobileapi.com/resend/

المعلمة:

المعلمة	وصف
guid	مطلوب GUID للرسالة التي سيتم إعادة إرسالها.

مثال:

احصل على https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

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

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

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

يحصل https://api.smsmobileapi.com/log/sent/sms/

المعلمة:

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

مثال:

احصل على https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

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

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

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

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

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

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

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

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

يحصل بريد https://api.smsmobileapi.com/log/sent/frommobile/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
date	اختياري. فلتر التاريخ الدقيق في YYYY-MM-DD شكل.
date_from	اختياري. تاريخ بدء الفترة في YYYY-MM-DD شكل.
date_to	اختياري. تاريخ انتهاء الفترة في YYYY-MM-DD شكل.
period	اختياري. فلتر فترة زمنية محددة مسبقًا. القيم المسموح بها: today, yesterday, last_24h, last_3days, last_7days.
number	اختياري. تصفية النتائج حسب رقم هاتف المستلم.
sIdentifiant	اختياري. تصفية حسب مُعرّف الهاتف المحمول.
message	اختياري. تصفية حسب محتوى الرسائل النصية القصيرة.
search	اختياري. بحث عالمي على sIdentifiant, number, message, mobile_date_formatted، و synchro_time.
sort_by	اختياري. حقل الفرز. القيم المسموح بها: sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted, synchro_time.
sort_order	اختياري. ترتيب الفرز: ASC أو DESC.
limit	اختياري. الحد الأقصى لعدد الصفوف المُعادة. القيمة القصوى المسموح بها: 200.

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

مجال	وصف
sIdentifiant	معرف الهاتف المحمول المرتبط بالرسالة النصية القصيرة المرسلة.
number	رقم هاتف المستلم.
message	محتوى الرسائل النصية القصيرة.
mobile_date_ms	الطابع الزمني الأصلي للرسالة النصية القصيرة بالمللي ثانية.
mobile_date_formatted	تم استلام التاريخ المنسق من الجهاز المحمول.
synchro_time	تاريخ ووقت مزامنة الرسائل النصية القصيرة مع SMSMobileAPI.

مثال:

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

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

طلب GET إلى https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&date=2026-03-13&number=32470000000&sort_by=synchro_time&sort_order=DESC

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

GET https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200

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

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

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

يحصل https://api.smsmobileapi.com/getsms/

المعلمة:

المعلمة	وصف
apikey	مطلوب مفتاح API الذي لديك أو سوف تتلقاه.
sIdentifiantPhone	عزل الهاتف المرتبط بالرسائل النصية القصيرة المستلمة.
after_timestamp_unix	تم استلام الرسائل النصية القصيرة من القائمة بعد طابع زمني بنظام يونكس.
onlyunread	"نعم" = عرض الرسائل النصية القصيرة فقط التي لم يتم وضع علامة عليها كمقروءة (حالة واجهة برمجة التطبيقات).

مثال:

احصل على https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

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

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

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

يحصل https://api.smsmobileapi.com/getsms/set-read/

المعلمة:

المعلمة	وصف
apikey	مطلوب مفتاح API الذي لديك أو سوف تتلقاه.
guid_message	مطلوب معرّف فريد عالمي (GUID) للرسالة المراد وضع علامة عليها كمقروءة.

مثال:

احصل على https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE

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

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

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

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

يحصل بريد https://api.smsmobileapi.com/getsms/update/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
guid	مطلوب معرف GUID الخاص بالرسالة النصية القصيرة المستلمة لتحديثها.
alias	مطلوب الاسم المستعار الذي سيتم تعيينه لهذه الرسالة النصية. يمكن ترك هذه القيمة فارغة لمسح الاسم المستعار الحالي.

مثال:

GET https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=JohnDoe

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

GET https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=

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

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

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

يحصل https://api.smsmobileapi.com/deletesms/

المعلمة:

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

مثال:

احصل على https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

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

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

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

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

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

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

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

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

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

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

يحصل بريد https://api.smsmobileapi.com/conversation/sms/list/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
origineConversation	مطلوب يُحدد هذا الخيار نقطة بداية قائمة المحادثات. القيم المسموح بها: received أو sent.
numero	خياري قم بتصفية النتائج لعرض رقم هاتف محدد واحد فقط.
date_from	خياري فلتر تاريخ البدء للمحادثات والرسائل. التنسيق المقبول: YYYY-MM-DD أو قيمة التاريخ والوقت الكاملة.
date_to	خياري فلتر تاريخ انتهاء المحادثات والرسائل. التنسيق المقبول: YYYY-MM-DD أو قيمة التاريخ والوقت الكاملة.
sort	خياري ترتيب فرز المحادثات. القيم المسموح بها: DESC أو ASC. تقصير: DESC.
limit	خياري الحد الأقصى لعدد المحادثات التي يجب الرد عليها عند numero غير متوفر. القيمة الافتراضية: 20.
resume	خياري إذا تم ضبطه على 1يتم إرجاع أحدث الرسائل فقط من كل محادثة.
resume_line_how	خياري عدد الرسائل الأخيرة التي يجب إرجاعها لكل محادثة عند resume=1. تقصير: 1.

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

يتم قراءة الرسائل النصية الواردة من logsmsreceive.
يتم قراءة الرسائل النصية الصادرة من logsmssent.
الرسائل الواردة تعود دائمًا direction = "incoming".
الرسائل الصادرة تعود دائمًا direction = "outgoing".
اسم جهة الاتصال مأخوذ من logsmsreceive.alias عند توفرها.
بالنسبة للرسائل النصية القصيرة الواردة، يأتي معرف الجهاز المحمول من sIdentifiant_pour_read.
بالنسبة للرسائل النصية القصيرة الصادرة، يأتي معرف الجهاز المحمول من send_from_mobile_sIdentifiant.
بالنسبة للرسائل النصية القصيرة الصادرة، يتم تعديل التاريخ المعروض باستخدام timearea_of_message إذا لم يكن هذا الحقل فارغًا.

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

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received

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

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent

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

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&numero=32470000001

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

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&date_from=2026-03-01&date_to=2026-03-31

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

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent&resume=1&resume_line_how=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	يشير إلى ما إذا كان الطلب قد تم بنجاح.
origineConversation	الوضع الابتدائي المستخدم لإنشاء قائمة المحادثات.
resume	يشير إلى ما إذا كان وضع الاستئناف مفعلاً.
resume_line_how	عدد الأسطر الأخيرة التي تم إرجاعها لكل محادثة عند تفعيل وضع الاستئناف.
conversations	مجموعة من المحادثات.
phone_number	رقم الهاتف المستخدم لتحديد المحادثة.
contact_alias	الاسم المستعار المرتبط برقم الهاتف عند توفره.
messages	مجموعة من رسائل SMS داخل المحادثة.
direction	incoming بالنسبة للرسائل النصية القصيرة المستلمة، outgoing بالنسبة للرسائل النصية القصيرة المرسلة.
message_id	المعرف الفريد للرسالة.
date	عرض تاريخ الرسالة. بالنسبة للرسائل النصية القصيرة الصادرة، يمكن تعديل هذه القيمة باستخدام timearea_of_message.
timestamp_utc	الطابع الزمني للرسالة بتوقيت UTC.
message	محتوى الرسالة.
status	received بالنسبة للرسائل النصية الواردة، sent لإرسال الرسائل النصية القصيرة.
mobile_sid	معرف الجهاز المحمول الذي استقبل الرسالة أو أرسلها.

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

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

ملحوظات:

لو numero في حال توفير رقم الهاتف هذا، فإن واجهة برمجة التطبيقات (API) لا تُرجع سوى المحادثة المرتبطة بهذا الرقم.
لو numero في حال عدم توفيرها، تقوم واجهة برمجة التطبيقات (API) بإرجاع أحدث المحادثات وفقًا لوضع المصدر المحدد.
يتم دمج الرسائل الواردة والصادرة في جدول زمني واحد لكل رقم هاتف.
يأخذ فرز الرسائل الصادرة التاريخ المحلي المعدل في الاعتبار عند timearea_of_message متوفر.
يُعد وضع الاستئناف مفيدًا للوحات المعلومات، والأدوات، والمعاينات، وملخصات المحادثات.

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

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

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

يحصل بريد https://api.smsmobileapi.com/gateway/mobile/list/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
sid	قم بالتصفية حسب معرف النظام المحدد (sIdentifiant_pour_check).
search	ابحث في الحقول (المعرف، التاريخ، البطارية، الإصدار، الملصق...).

مثال:

GET https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY

ملاحظة: تتوفر إحصائيات الرسائل النصية القصيرة المستلمة بدءًا من الإصدار 3.0.33.3+ من تطبيق الهاتف المحمول.

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

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

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

يحصل بريد https://api.smsmobileapi.com/gateway/mobile/update/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
sid	مطلوب معرف الجهاز (sIdentifiant_pour_check).
label	ملصق جديد
phone_number	رقم هاتف جديد

مثال:

GET https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=SID&label=OfficePhone

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

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

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

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

يحصل بريد https://api.smsmobileapi.com/gateway/mobile/delete/

حدود:

المعلمة	وصف
apikey	مطلوب مفتاح API الخاص بك.
sid	مطلوب معرف الجهاز (sIdentifiant_pour_check).

مثال:

GET https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=SID

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

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

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

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

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

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

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


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=YOUR_CLIENT_ID" \

-d "client_secret=YOUR_CLIENT_SECRET"

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


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "التفويض: حامل رمز الوصول الخاص بك" \

-H "نوع المحتوى: application/x-www-form-urlencoded" \

-d "المستلمون=+1234567890" \

-d "الرسالة=مرحبا"

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

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

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

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

عنوان URL لـ WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

حدود:

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

مثال


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

إرسال الرسائل القصيرة وواتساب

أمر cURL الأساسي


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

إرسال الرسائل القصيرة وواتساب

استخدم وحدة بايثون الرسمية الخاصة بنا: https://smsmobileapi.com/python/


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {"recipients":"PHONE_NUMBER","message":"YOUR_MESSAGE","apikey":"YOUR_API_KEY"}


response = requests.post(url, data=payload)

print(response.text)

SMS Mobile API - PHP SDK (Composer)

يتطلب الملحن smsmobileapi/sdk

جيت هاب: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

إرسال الرسائل القصيرة وواتساب


const url = "https://api.smsmobileapi.com/sendsms/";

const data = {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"};

fetch(url,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams(data)})

.then(r=>r.text()).then(console.log);

إرسال الرسائل القصيرة وواتساب


const axios = require("axios");

axios.post("https://api.smsmobileapi.com/sendsms/", {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"})

.then(r=>console.log(r.data));

إرسال الرسائل القصيرة وواتساب


require "net/http"

require "uri"

uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

req = Net::HTTP::Post.new(uri)

req.set_form_data({"recipients"=>"PHONE_NUMBER","message"=>"YOUR_MESSAGE","apikey"=>"YOUR_API_KEY"})

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true){|http| http.request(req)}

puts res.body

انقر هنا لاختبار مفتاح API والخدمة باستخدام النموذج البسيط

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

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

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

كيفية إنشاء مفتاح API؟

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

أين يمكنني دائمًا العثور على مفتاح API الخاص بي؟

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

هل يمكن أن يكون إنشاء مفتاح API مجهولاً؟

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

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

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

تنزيل التطبيق

وثائق API والمطور

سجل الأدوات والتغييرات

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

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

حدود:

مثال:

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

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

المعلمة:

مثال:

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

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

المعلمة:

مثال:

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

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

حدود:

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

مثال:

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

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

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

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

المعلمة:

مثال:

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

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

المعلمة:

مثال:

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

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

حدود:

مثال:

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

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

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

المعلمة:

مثال:

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

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

حدود:

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

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

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

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

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

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

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

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

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

ملحوظات:

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

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

حدود:

مثال:

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

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

حدود:

مثال:

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

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

حدود:

مثال:

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

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

حمولة الويب هوك

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

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

اختبار Webhook

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

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

المصادقة

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

2. مصادقة OAuth2

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

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

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

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

عنوان URL لـ WSDL

حدود: