كيفية حذف رسالة SMS في Visual Basic

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

كود Visual Basic لحذف رسالة SMS

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

Imports Ozeki.Libs.Rest

Module ReceiveSMS
    Sub Main(args As String())

        Dim configuration As New Configuration
        configuration.Username = "http_user"
        configuration.Password = "qwe123"
        configuration.ApiUrl = "http://127.0.0.1:9509/api"

        Dim msg As New Message
        msg.ID = "69022e7a-305c-4f01-8063-7f9d65f5ca49"
        //يمكنك استبدال هذا بمعرف الرسالة التي تريد حذفها

        Dim api As New MessageApi(configuration)

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

        Console.WriteLine(result)
        Console.ReadKey()

    End Sub
End Module
	

كيفية استخدام مثال Visual Basic لرسائل SMS:

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

تحميل DeleteSms.vb

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

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

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

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

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

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

قم بتثبيت Ozeki SMS Gateway وإنشاء مستخدم لواجهة برمجة تطبيقات HTTP

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

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

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

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

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

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

لمصادقة عميل Visual Basic لرسائل SMS، تحتاج إلى إرسال اسم المستخدم وكلمة المرور في سلسلة مشفرة بـ 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 لحذف الرسائل القصيرة من Visual Basic

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

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

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

لطلب حذف الرسائل القصيرة، سيرسل تطبيق Visual Basic الخاص بك طلب 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":	[
		"69022e7a-305c-4f01-8063-7f9d65f5ca49"
		]
}
	

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

بمجرد استلام بوابة الرسائل القصيرة لهذا الطلب، ستقوم بإنشاء استجابة 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": [
        "69022e7a-305c-4f01-8063-7f9d65f5ca49"
      ]
    }
}
	

مثال الرسائل القصيرة في Visual Basic: DeleteSms.sln

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

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

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

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

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

تشغيل مثال الرسائل القصيرة في Visual Basic على Windows

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

الختام

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

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

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

الآن كل ما عليك فعله هو تنزيل بوابة Ozeki SMS وابدأ العمل!