كيفية حذف رسالة SMS في Scala

أسهل طريقة لحذف رسائل SMS من Scala هي استخدام واجهة برمجة تطبيقات HTTP/Rest المدمجة في Ozeki SMS Gateway. عند استخدام هذه الواجهة، ستقوم بحذف رسائل SMS عن طريق إرسال طلب HTTP Post إلى بوابة الرسائل. سيحتوي طلب HTTP Post على نص منسق بتنسيق JSON يتضمن معرّفات الرسائل التي نرغب في حذفها. ستقوم بوابة الرسائل بإرسال معرّفات الرسائل التي تم حذفها بنجاح إلى تطبيقك العميل في Scala، وسيتم إرجاع استجابة HTTP 200 OK لطلبك.

يوضح مثال كود SMS في Scala أدناه كيفية إرسال رسالة SMS مجدولة باستخدام واجهة برمجة تطبيقات HTTP Rest الخاصة بـ Ozeki SMS Gateway باستخدام مكتبة Ozeki.Libs.Rest في Scala. هذه المكتبة مقدمة لك مجانًا، ويمكنك استخدامها وتعديلها في أي من مشاريعك.

import Ozeki.Libs.Rest.{ Configuration, Message, MessageApi, Folder }


object main  {
  def main(args: Array[String]): Unit = {

    val configuration = Configuration(
      Username = "http_user",
      Password = "qwe123",
      ApiUrl = "http://127.0.0.1:9509/api"
    )

    val msg = Message(
        ID = "a1762c9d-c165-434b-8cd5-df895358e870"
    )

    val api = MessageApi(configuration)

    val result = api.Delete(Folder.Inbox, msg)

    println(result)
  }
}
	

كيفية استخدام مثال SMS في Scala:

يمكن استخدام مثال SMS في Scala هذا في أي تطبيق Scala. لاستخدامه، يجب عليك تنزيل مكتبة Ozeki.Libs.Rest. بعد تنزيل المكتبة، تحتاج إلى إضافة مرجع إليها في كود المصدر الخاص بك في Scala. سيسمح لك ذلك باستخدام الفئات المقدمة من مكتبة Ozeki.Libs.Rest. يمكنك استخدام فئة Message لإنشاء الرسالة SMS. يمكنك استخدام فئة MessageApi لحذف الرسالة SMS وإرسالها إلى بوابة الرسائل. ستقوم بوابة الرسائل بإعادة توجيه رسالتك إلى شبكة الهاتف المحمول إما عبر اتصال لاسلكي أو عبر الإنترنت.

يمكن تنزيل كود المصدر الموضح في هذه المقالة واستخدامه وتعديله مجانًا.
تنزيل: DeleteSms.scala.zip (90.5Kb)

في ملف DeleteSms.scala.zip ستجد ملف DeleteSms.scala، الذي يحتوي على كود المثال ليوضح لك كيفية إرسال رسالة SMS. كود المثال هذا مدرج أدناه.

لحذف رسائل SMS من Scala:

1. تثبيت مستخدم واجهة برمجة تطبيقات HTTP
2. تمكين تسجيل أحداث الاتصال في علامة التبويب المتقدمة
3. إعداد Visual Studio
4. تنزيل ثم استخراج ملف DeleteSms.scala.zip
5. فتح مشروع DeleteSms.scala باستخدام بيئة التطوير IntelliJ IDE
6. تشغيل تطبيق Ozeki SMS Gateway
7. تنفيذ كود DeleteSms.scala في Scala عن طريق تشغيله في بيئة IntelliJ IDE
8. التحقق من السجلات لمعرفة ما إذا كانت الرسالة SMS قد أرسلت

لتتمكن من حذف رسائل SMS من Scala، تحتاج أولاً إلى إنشاء مستخدم لواجهة برمجة تطبيقات SMS عبر HTTP. قم بإنشاء مستخدم باسم مستخدم "http_user"، وكلمة مرور "qwe123" لجعل المثال يعمل دون تعديل.

بعد إعداد البيئة، يمكنك تشغيل كود Scala الخاص بك.

لإرسال رسائل SMS من Scala، سيتعين على تطبيقك في Scala إرسال طلب HTTP إلى بوابة الرسائل. يظهر رابط الواجهة أدناه. لاحظ أنه يجب استبدال عنوان IP (127.0.0.1) بعنوان IP الخاص ببوابة الرسائل لديك. إذا كان Ozeki SMS Gateway مثبتًا على نفس الكمبيوتر الذي يعمل عليه تطبيق R sms، فيمكن أن يكون هذا العنوان 127.0.0.1. إذا كان مثبتًا على كمبيوتر مختلف، فيجب أن يكون عنوان IP الخاص بذلك الكمبيوتر.

http://127.0.0.1:9509/api?action=rest
	

لمصادقة عميل SMS في Scala، تحتاج إلى إرسال اسم المستخدم وكلمة المرور في سلسلة مشفرة بـ base64 إلى الخادم في طلب HTTP. التنسيق المستخدم هو: base64(username+":"+password). في Scala، يمكنك استخدام الكود التالي لإجراء هذا التشفير:

val usernamePassword = "%s:%s".format(Username, Password).getBytes()
val usernamePasswordEncoded = Base64.getEncoder.encodeToString(usernamePassword)
"Basic %s".format(usernamePasswordEncoded)
	

على سبيل المثال، إذا قمت بتشفير اسم المستخدم 'http_user' وكلمة المرور 'qwe123'، فستحصل على السلسلة المشفرة بـ base64 التالية: aHR0cF91c2VyOnF3ZTEyMw==. لإرسال

لحذف رسائل SMS، تحتاج إلى تضمين الأسطر التالية كرؤوس في طلب HTTP. لاحظ أننا ندرج نوع المحتوى ورأس المصادقة.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
	

طلب HTTP لحذف الرسائل القصيرة من Scala

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

POST /api?action=deletemsg HTTP/1.1
HTTP2-Settings: AAEAAEAAAAIAAAABAAMAAABkAAQBAAAAAAUAAEAA
Connection: Upgrade, HTTP2-Settings
Upgrade: h2c
Content-Length: 73
Content-Type: application/json
Accept: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Java-http-client/16.0.1

{
	"folder": "inbox",
	"message_ids": [
		"6fbaf86f-64d7-41ae-a45c-bb5af3198619"
	]
}
	

استجابة HTTP المستلمة من مثال الرسائل القصيرة في Scala

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

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 15 Jul 2021 12:04:21 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "6fbaf86f-64d7-41ae-a45c-bb5af3198619"
	  ]
	}
}
	

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

يعرض هذا الفيديو كيفية تنزيل ملف DeleteSms.scala.zip من هذه الصفحة. إذا شاهدت الفيديو، ستلاحظ أن محتويات ملف DeleteSms.scala.zip تم وضعها على سطح مكتب Windows. سترى أيضًا أننا نقوم بتشغيل موجه الأوامر لإرسال الرسالة القصيرة.

مثال على الرسائل القصيرة في Scala: DeleteSms.scala

كود المثال أدناه هو جزء من ملف DeleteSms.scala.

كيفية التحقق من قبول الرسالة القصيرة من قبل مستخدم HTTP

بعد إرسال الرسالة القصيرة، من الجيد التحقق من بوابة الرسائل القصيرة الخاصة بك، لمعرفة ما تم استلامه. يمكنك التحقق من السجل عن طريق فتح تفاصيل مستخدم HTTP من وحدة تحكم إدارة بوابة Ozeki SMS. يعرض الفيديو التالي ما يجب البحث عنه.

الختام

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

تأكد من مواصلة القراءة على صفحة البرامج التعليمية لـ Ozeki حيث يمكن العثور على المزيد من المعلومات حول مواضيع مثل استقبال الرسائل القصيرة في Scala.

الآن الشيء الوحيد المتبقي هو تنزيل بوابة Ozeki SMS Gateway والبدء في العمل!