كيفية حذف رسالة SMS في Tcl/Tk

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

كيفية حذف رسالة sms في tcl tk
الشكل 1 - كيفية حذف رسالة SMS في Tcl/Tk

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

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

DeleteSms.tcl
source Ozeki.Libs.Rest.tcl


set configuration [ Configuration new ]
$configuration setUsername "http_user" 
$configuration setPassword "qwe123"
$configuration setApiUrl "http://127.0.0.1:9509/api"

set msg [ Message new ]
$msg setID "fef636bc-b17f-4bb6-911a-087e3dc677fc"

set api [ MessageApi new $configuration ]

set result [ $api delete [ Folder Inbox ] $msg ]

puts $result
	

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

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

تحميل DeleteSms.tcl

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

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

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

دليل استقبال رسائل sms في tcl
الشكل 2 - ما الموجود داخل DeleteSms.tcl.zip

كيفية إرسال رسالة SMS من Tcl/Tk (إرشادات بسيطة)

لإرسال رسالة SMS من Tcl/Tk:

  1. قم بتثبيت مستخدم HTTP API
  2. قم بتمكين تسجيل أحداث الاتصال في علامة التبويب المتقدمة
  3. قم بتنزيل وتثبيت مكتبة Tcllib
  4. قم بتنزيل ثم استخراج ملف DeleteSms.tcl.zip
  5. افتح ملف DeleteSms.tcl في محرر نصوص
  6. قم بتشغيل تطبيق Ozeki SMS Gateway
  7. قم بتشغيل كود Tcl/Tk DeleteSms.tcl في الطرفية
  8. تحقق من السجلات لمعرفة ما إذا تم إرسال الرسالة القصيرة

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

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

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

رابط HTTP API لاستخدام إرسال رسالة SMS من Tcl/Tk

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

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

مصادقة HTTP لاستخدام إرسال رسالة SMS من Tcl/Tk

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

set usernamePassword "$username:$password"
set usernamePasswordEncoded [ binary encode base64 $usernamePassword ]
return "Basic $usernamePasswordEncoded"
	

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

رأس طلب HTTP لإرسال رسالة SMS من Tcl/Tk

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

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

طلب HTTP لإرسال رسالة SMS من Tcl/Tk

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

POST /api?action=deletemsg HTTP/1.1
Host: 127.0.0.1:9509
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 10.0) http/2.9.0 Tcl/8.6.9
Connection: close
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Accept: */*
Accept-Encoding: gzip,deflate,compress
Content-Type: application/json
Content-Length: 73

{
	"folder": "inbox",
	"message_ids": [
		"836701c7-3c59-4678-8b79-7896eae777fc"
	]
}
	

استجابة HTTP المستلمة من مثال Tcl/Tk لرسائل SMS

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

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/json; charset=utf8
Last-Modified: Wed, 04 Aug 2021 08:44:43 GMT
Server: 10/10.3.124 Microsoft-HTTPAPI/2.0
User-Agent: OZEKI 10.3.124 (www.myozeki.com)
Access-Control-Allow-Origin: *
Date: Wed, 04 Aug 2021 10:39:30 GMT
Connection: close

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "",
  "data": {
    "folder": "inbox",
    "message_ids": [
      "836701c7-3c59-4678-8b79-7896eae777fc"
    ]
  }
}
	

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

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

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

مثال Tcl/Tk لرسائل SMS: DeleteSms.tcl

كود المثال أدناه هو جزء من ملف DeleteSms.tcl.zip. في الملف المضغوط، يمكنك العثور على ملفين: DeleteSms.tcl و Ozeki.Libs.Rest.tcl.

كيفية حذف رسالة SMS باستخدام Tcl
الشكل 3 - DeleteSms.tcl

كيفية التحقق من قبول HTTP user لرسالة SMS (فيديو تعليمي)

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

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

More information