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

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

كيفية حذف رسالة SMS من جافا
الشكل 1 - كيفية حذف رسالة SMS من جافا

كود جافا لإرسال رسالة SMS إلى الهاتف المحمول

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

Main.java
import Ozeki.Libs.Rest.*;

public class Main {

    public static void main(String[] args) {

        var configuration = new Configuration();
        configuration.Username = "http_user";
        configuration.Password = "qwe123";
        configuration.ApiURL = "http://127.0.0.1:9509/api";

        var msg = new Message();
        msg.ID = "73538ac0-f27c-4eaf-ba4c-6193aebe477c";

        var api = new MessageApi(configuration);
        
        var result = api.Delete(Folder.Inbox, msg);
        
        System.out.println(result);
    }
}
	

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

يمكنك استخدام فئة Message لإنشاء الرسالة القصيرة ويمكنك استخدام فئة MessageApi لإرسال الطلب لحذف الرسالة القصيرة من مجلد الوارد.

تحميل DeleteSms.java

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

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

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

الشكل 2 - دليل DeleteSms.java

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

لحذف رسالة SMS من جافا:

  1. قم بتثبيت بوابة Ozeki SMS
  2. قم بتوصيل بوابة Ozeki SMS بشبكة الهاتف المحمول
  3. أرسل رسالة SMS تجريبية من واجهة Ozeki
  4. قم بإنشاء مستخدم لواجهة برمجة تطبيقات HTTP لإرسال الرسائل القصيرة
  5. Apache NetBeans
  6. قم بإنشاء مشروع باسم DeleteSms
  7. ضع الكود في ملف Main.java جديد أو استخدم ملف Main.java الموجود في ملف .zip
  8. قم بإنشاء الرسالة القصيرة عن طريق إنشاء كائن Message جديد
  9. في كائن Message، حدد سمة ID
  10. قم بإنشاء واجهة برمجة تطبيقات لحذف رسالتك
  11. استخدم طريقة Delete لحذف رسالتك
  12. اقرأ رسالة الاستجابة على وحدة التحكم
  13. تحقق من السجلات في بوابة الرسائل القصيرة

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

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

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

رابط واجهة برمجة تطبيقات HTTP لاستخدام إرسال رسائل SMS من جافا

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

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

مصادقة HTTP لاستخدام حذف رسائل SMS من جافا

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

var usernamePassword = username + ":" + password;
var encodedUsernamePassword = usernamePassword.getBytes();
return "Basic " + Base64.getEncoder().encodeToString(encodedUsernamePassword);
	

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

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

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

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

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

لحذف الرسالة النصية، سيقوم تطبيق جافا الخاص بك بإرسال طلب 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/15.0.3
{
	"folder":	"inbox",
	"message_ids":[
		"73538ac0-f27c-4eaf-ba4c-6193aebe477c"
		]
}
	

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

بمجرد استلام بوابة الرسائل النصية لهذا الطلب، ستقوم بإنشاء استجابة 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 09:53:10 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked 
{
    "http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "",
    "data": {
      "folder": "inbox",
      "message_ids": [
        "73538ac0-f27c-4eaf-ba4c-6193aebe477c"
      ]
    }
}
	

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

يُظهر لك هذا الفيديو كيفية إنشاء مشروع جديد في Apache NetBeans، وكيفية تسميته DeleteSMS. بمجرد إنشاء الحل، قد تلاحظ وجود مجلد يسمى <default package> في مشروعك داخل مجلد Source Packages. هذا هو المكان الذي ستقوم فيه بإنشاء أو لصق ملف Main.java. ثم يتعين عليك لصق مجلد Ozeki في مجلد Source packages وهذه كل التحضيرات التي تحتاجها لحذف رسالة نصية باستخدام جافا.

الفيديو 1 - كيفية تنزيل Ozeki.Libs.Rest وإعداد مشروعك (فيديو تعليمي)

مثال جافا لحذف الرسائل النصية: Main.java

الشكل 3 - مشروع DeleteSms

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

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

الفيديو 2 - كيفية حذف رسالة نصية باستخدام كود جافا أعلاه (فيديو تعليمي)

الختام

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

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

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

More information