كيفية حذف رسالة SMS باستخدام F#

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

حذف رسائل SMS باستخدام F#
الشكل 1 - حذف رسائل SMS باستخدام F#

كود F# لحذف رسالة SMS

يوضح مثال كود F# للرسائل القصيرة أدناه كيف يمكنك حذف رسائل SMS باستخدام واجهة برمجة تطبيقات REST لبوابة Ozeki SMS باستخدام مكتبة Ozeki.Libs.Rest في F#. هذه المكتبة مقدمة لك مجانًا، ويمكنك استخدامها وتعديلها في أي من مشاريعك.

Program.fs
open Ozeki.Libs.Rest

[]
let main argv =
    let configuration = new Configuration (
        Username = "http_user",
        Password = "qwe123",
        ApiUrl = "http://127.0.0.1:9509/api")

    let msg = new Message(
        ID = "ba088274-caac-4e45-bf24-10a446d677e5")

    let api = new MessageApi(configuration)

    let result = api.Delete(Folder.Inbox, msg);

    printfn $"{result}"
    0

كيفية استخدام مثال F# للرسائل القصيرة:

يمكن استخدام مثال F# للرسائل القصيرة هذا في أي تطبيق .NET أو .NET core. لاستخدامه، يجب عليك إضافة ملف Ozeki.Libs.Rest.dll كمرجع إلى مشروعك. بعد إضافة المرجع، يجب وضع التوجيه using Ozeki.Libs.Rest; في قسم الرأس من كود F# المصدر. سيسمح لك ذلك باستخدام الفئات المقدمة من مكتبة Ozeki.Libs.Rest. يمكنك استخدام فئة MessageApi لـ حذف الرسائل القصيرة من بوابة الرسائل القصيرة.

تنزيل DeleteSms.fs

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

ما الموجود في ملف DeleteSms.fs.zip؟

يحتوي ملف DeleteSms.fs.zip على مكتبة Ozeki.Libs.Rest، والتي تمنحك جميع الأدوات اللازمة لإرسال وتحديد وحذف واستقبال رسائل SMS. ستجد أيضًا مشروع DeleteSms في الملف المضغوط، والذي يحتوي على الكود المثال ليوضح لك كيفية حذف رسالة SMS. هذا الكود المثال مدرج أدناه.

ما الموجود في ملف Ozeki Delete SMS المضغوط
الشكل 2 - ما الموجود داخل DeleteSms.fs.zip

كيفية حذف رسائل SMS من F# (خطوات سريعة)

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

  1. قم بتثبيت بوابة Ozeki SMS
  2. قم بتوصيل بوابة Ozeki SMS بالشبكة المحمولة
  3. أرسل رسالة SMS تجريبية من واجهة Ozeki
  4. قم بإنشاء مستخدم لواجهة برمجة تطبيقات HTTP للرسائل القصيرة
  5. ابدأ تشغيل Visual Studio
  6. قم بإنشاء حل يسمى DeleteSms.sln
  7. أضف مشروع وحدة تحكم F#: DeleteSms.fsproj
  8. ضع الكود في Program.fs أو DeleteSms.fs
  9. قم بإنشاء طلب HTTP لحذف الرسالة القصيرة
  10. اقرأ استجابة HTTP
  11. اكتب الاستجابة على وحدة التحكم
  12. تحقق من السجلات في بوابة الرسائل القصيرة

قم بتثبيت بوابة Ozeki SMS وأنشئ مستخدمًا لواجهة برمجة تطبيقات HTTP

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

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

رابط واجهة برمجة تطبيقات HTTP لاستقبال رسائل SMS من F#

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

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

مصادقة HTTP لحذف رسائل SMS من F#

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

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));
	

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

رأس طلب HTTP لحذف رسائل SMS من F#

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

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

طلب HTTP لحذف الرسائل القصيرة باستخدام F#

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

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
{
	"folder":	"inbox",
	"message_ids":	[
		"bc7b1368-b496-4350-ba02-7ba36b770618"
		]
}
	

استجابة HTTP المستلمة من مثال الرسائل القصيرة بـ F#

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

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 10 Jun 2021 11:02:26 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "",
    "data": {
      "folder": "inbox",
      "message_ids": [
        "bc7b1368-b496-4350-ba02-7ba36b770618"
      ]
    }
}
	

مثال الرسائل القصيرة بـ F#: DeleteSms.sln


كيفية تنزيل واستخدام مشروع DeleteSms (فيديو تعليمي)

في هذا الفيديو، ستتعلم كيفية تنزيل مشروع DeleteSms المثال بلغة F#. يبدأ الفيديو بصفحة التنزيل وينتهي بفتح المشروع. ستتعلم كيفية تنزيل المشروع وما يجب فعله لبدء حذف الرسائل القصيرة. يبلغ طول الفيديو 58 ثانية فقط، ولكنه مفيد جدًا. بفضل هذه التفاصيل، لن تواجه أي مشكلة في اتباع الخطوات.

الفيديو 1 - كيفية تنزيل وتشغيل المشروع المثال أعلاه (فيديو تعليمي)

كود المثال أدناه هو جزء من حل Visual Studio DeleteSms.sln. يمكن أن يحتوي حل Visual Studio على مشاريع وملفات متعددة. في هذا الحل هناك مشروعان فقط: DeleteSms.fsproj، Ozeki.Libs.Rest.csproj، وملف واحد: Program.fs.

الشكل 3 - DeleteSms.sln

كيفية استخدام المشروع لحذف الرسائل

في هذا الفيديو، ستتعلم كيفية استخدام المشروع لحذف الرسائل القصيرة باستخدام F#. سيبدأ الفيديو بفتح بوابة Ozeki للرسائل القصيرة وسيأخذك حتى التحقق من مجلد الوارد الفارغ. ستتعلم أيضًا كيفية فتح علامة تبويب الأحداث ورؤية جميع السجلات المتعلقة بالرسائل. يبلغ طول الفيديو 54 ثانية فقط وهو مفصل جدًا. بفضل ذلك، لن تواجه أي مشكلة في اتباع البرنامج التعليمي.

الفيديو 2 - كيفية استخدام حل DeleteSms.fs (فيديو تعليمي)

تشغيل مثال الرسائل القصيرة بـ F# على Windows

عند استخدام Windows لتشغيل هذا المثال للرسائل القصيرة المكتوب بلغة F#، ستلاحظ أن الأداء يكون أفضل قليلاً مقارنة بتشغيله على Linux. لفهم سبب حدوث ذلك، يجب أن تضع في اعتبارك أن F# تستخدم إطار عمل .NET لتنفيذ الكود. وذلك لأن تنفيذ .NET على Windows مُحسّن للأداء، بينما mono، وهو تنفيذ .NET على Linux، ما زال يحتاج إلى بعض التحسينات في هذا المجال.

ملخص

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

تأكد من أنك لا تنهي دراستك هنا، تحقق من صفحة البرامج التعليمية لـ Ozekي واقرأ عن مواضيع مثل استلام الرسائل بـ F#.

الشيء الوحيد المتبقي هو تنزيل بوابة Ozeki للرسائل القصيرة والبدء في العمل الآن!

More information