كيفية حذف رسالة SMS في روبي

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

كود روبي لحذف رسائل SMS

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

require 'ozeki_libs_rest'

configuration = Configuration.new(
    "http_user",
    "qwe123",
    "http://127.0.0.1:9509/api"
);

msg = Message.new
msg.id = "f53efb1a-8ff6-4e62-97c3-2c1e81964b9d"

api = MessageApi.new(configuration)

result = api.delete(Folder.new.inbox, msg)

print(result)
	

تنزيل DeleteSms.rb

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

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

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

كيفية حذف رسالة SMS باستخدام روبي (خطوات سريعة)

لحذف رسالة SMS باستخدام روبي:

1. قم بتنزيل ملف DeleteSms.rb.zip
2. استخرج ملف .zip من مجلد التنزيلات
3. افتح ملف DeleteSms.rb في أي محرر نصوص مثل Windows Notepad
4. قم بتشغيل بوابة Ozeki SMS
5. قم بإنشاء مستخدم HTTP API في Ozeki
6. قم بتشغيل كود روبي DeleteSms.rb باستخدام موجه الأوامر
7. تحقق من صندوق المرسلة في بوابة Ozeki SMS

تثبيت بوابة Ozeki SMS وإنشاء مستخدم HTTP API

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

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

رابط HTTP API لإرسال SMS من روبي

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

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

مصادقة HTTP لإرسال SMS من روبي

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

username_password = username + ':' + password
username_password_encoded = Base64.encode64(username_password)
'Basic ' + username_password_encoded
	

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

رأس طلب HTTP لإرسال SMS من روبي

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

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

طلب HTTP لإرسال الرسائل القصيرة من روبي

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

POST /api?action=deletemsg HTTP/1.1
Content-Length: 73
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Faraday v1.5.0

{	
	"folder":	"inbox",
	"message_ids":	[
		"8ddff323-a0e1-474f-b4b1-58d7fed30009"
	]
}
	

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

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

User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 06 Jul 2021 15:58:36 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "8ddff323-a0e1-474f-b4b1-58d7fed30009"
	  ]
	}
}
	

مثال الرسائل القصيرة بروبي: DeleteSms.rb

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

كود المثال

كود المثال أدناه هو جزء من ملف DeleteSms.rb. سيقوم كود روبي هذا بحذف الرسالة ذات المعرف المخزن في المتغير msg.id (الشكل 3). يمكنك تعديل المتغير بحيث يحذف الكود رسالة أخرى. إذا كنت معتادًا على لغة برمجة روبي، فلا تتردد في تعديل الكود حسب رغبتك.

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

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

ملخص

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

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

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