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

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

كيفية حذف رسالة SMS في R
الشكل 1 - كيفية حذف رسالة SMS في R

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

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

DeleteSms.R 
library(Ozeki.Libs.Rest)


configuration <- Ozeki.Libs.Rest::Configuration$new(
  username = "http_user",
  password = "qwe123",
  api_url = "http://127.0.0.1:9509/api"
)

msg <- Ozeki.Libs.Rest::Message$new()
msg$id <- "c2f9d31b-d8ee-4304-a173-9d088b5c015d"

api <- Ozeki.Libs.Rest::MessageApi$new(configuration)

result <- api$delete(Ozeki.Libs.Rest::Folder$Inbox, msg)

print(result)

الكود 1 - DeleteSms.R

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

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

تنزيل DeleteSms.R

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

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

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

كود مصدر R لحذف رسالة SMS
الشكل 2 - ما الموجود داخل DeleteSms.R.zip

كيفية حذف رسالة SMS من R (إرشادات بسيطة)

لإرسال رسالة SMS من R:

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

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

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

رابط HTTP API لاستخدام حذف رسالة SMS من R

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

http://127.0.0.1:9509/api?action=rest
مصادقة HTTP لاستخدام حذف رسالة SMS من R

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

username_password <- paste(username, ":", password, sep="")
username_password_encoded <- base64enc::base64encode(charToRaw(username_password))
return (paste("Basic", username_password_encoded, sep=" "))

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

رأس طلب HTTP لحذف رسالة SMS من R

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

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

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

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

POST /api?action=deletemsg HTTP/1.1
Content-Length: 73
Content-Type: application/json
Accept: application/json
Accept-Encoding: deflate, gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: libcurl/7.64.1 r-curl/4.3.2 httr/1.4.2

{
  "folder": "inbox",
  "message_ids": [
    "dda7d1e5-149b-4ce4-b096-f1687b049c6f"
  ]
}

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

بمجرد استلام بوابة الرسائل القصيرة لهذا الطلب، ستقوم بإنشاء استجابة 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: Tue, 13 Jul 2021 15:57:11 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
 
{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "",
  "data": {
    "folder": "inbox",
    "message_ids": [
      "dda7d1e5-149b-4ce4-b096-f1687b049c6f"
    ]
  }
}

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

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

الفيديو 1 - كيفية إرسال الرسائل القصيرة من R باستخدام واجهة برمجة تطبيقات الرسائل القصيرة في R (فيديو تعليمي)

مثال الرسائل القصيرة في R: DeleteSms.R

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

الشكل 3 - ملف DeleteSms.R

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

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

الفيديو 2 - كيفية التحقق من قبول الرسالة القصيرة من قبل مستخدم HTTP (فيديو تعليمي)

ملخص

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

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

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

More information