كيفية حذف رسالة SMS في Node.js

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

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

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

import { Configuration, Folder, Message, MessageApi } from './Ozeki.Libs.Rest.js';


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 = "49c4bec8-348b-42c4-ba56-dee741bc3160";

var api = new MessageApi(configuration);

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

console.log(result);
	

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

يمكنك استخدام فئة Message لإنشاء الرسالة النصية، ويمكنك استخدام فئة MessageApi لإرسال الرسالة النصية إلى بوابة الرسائل. ستقوم بوابة الرسائل بإعادة توجيه رسالتك إلى شبكة الهاتف المحمول إما عبر اتصال لاسلكي أو عبر الإنترنت.

تحميل DeleteSms.js

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

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

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

هذا المشروع له تبعيات، لذا قبل البدء يجب عليك تثبيت حزمة node-fetch باستخدام الأمر التالي:

npm install node-fetch
	

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

لحذف رسائل SMS من Node.js:

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

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

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

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

رابط واجهة برمجة تطبيقات HTTP لاستقبال رسائل SMS من Node.js

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

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

مصادقة HTTP لاستخدام إرسال رسائل SMS من JavaScript

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

var usernamePassword = username + ":" + password;
return `Basic ${Base64.encode(usernamePassword)}`;
	

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

رأس طلب HTTP لإرسال الرسائل القصيرة من جافا سكريبت

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

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

طلب HTTP لإرسال الرسائل القصيرة من Node.Js

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

POST /api?action=deletemsg HTTP/1.1
Connection: close
Content-Length: 73
Content-Type: application/json
Accept: */*
Accept-Encoding: gzip,deflate
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: node-fetch/1.0 (+https://github.com/bitinn/node-fetch)

{
	"folder":	"inbox",
	"message_ids":	[
		"9bd34eb0-244b-4b8e-8115-1f05b3b1ac19"
	]
}
	

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

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

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 09:12:00 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "9bd34eb0-244b-4b8e-8115-1f05b3b1ac19"
	  ]
	}
}
	

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

يظهر لك هذا الفيديو كيفية تنزيل واستخدام مشروع DeleteSms.js. بمجرد إضافة الملفات المطلوبة إلى مشروعك، قد تلاحظ وجود ملف يسمى Ozeki.Lbis.Rest.js. هذا هو الملف الذي يحتوي على MessageApi وكل ما تحتاجه لحذف رسالة قصيرة باستخدام جافا سكريبت.

مثال Node.Js للرسائل القصيرة: DeleteSms.mjs (في Notepad)

في الشكل التالي، يمكنك رؤية الكود المصدري لمشروع Node.js 'DeleteSMS.mjs' (الشكل 3). كما ترى، استخدمنا Notepad لفتح الكود. يمكنك استخدامه لتعديله أيضًا. قم بتغيير قيمة المتغير msg.ID واحذف أي رسالة تريدها.

مثال Node.Js للرسائل القصيرة: DeleteSms.mjs (في Visual Studio Code)

إذا كنت ترغب في استخدام بيئة تطوير متكاملة توفر ترميزًا بالألوان، وثائق مساعدة، وملحقات، استخدم Visual Studio Code. إنها بيئة برمجة خفيفة الوزن ومجانية يمكنك البدء في استخدامها الآن. قم بتغيير قيمة المتغير msg.ID واحذف أي رسالة تريدها.

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

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

للتلخيص

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

استمر في قراءة مواضيع مثل هذه على صفحة Ozekي، ستجد العديد من المقالات الأخرى. دعنا نتحقق من المزيد من واجهات برمجة تطبيقات الرسائل القصيرة في مستودع GitHub الخاص بنا، تعرف على الاستخدام من دليل Github: Node.js SMS API.

غيّر للأفضل، حمل بوابة الرسائل القصيرة Ozeki الآن!