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

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

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

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

يوضح مثال كود Go لرسائل SMS أدناه كيف يمكنك حذف رسائل SMS باستخدام واجهة برمجة تطبيقات HTTP Rest الخاصة بـ Ozeki SMS Gateway باستخدام حزمة github.com/ozekisms/go_send_sms_http_rest_ozeki في Go. هذه الحزمة مقدمة لك مجانًا، ويمكنك استخدامها وتعديلها في أي من مشاريعك.

DeleteSms.go
package main

import (
	"fmt"

	ozeki "github.com/ozekisms/go_send_sms_http_rest_ozeki"
)

func main() {
	configuration := ozeki.NewConfiguration(
		"http_user",
		"qwe123",
		"http://127.0.0.1:9509/api",
	)

	msg := ozeki.NewMessage()
	msg.ID = "eb22f84e-dfe7-11eb-93ad-74d4355e997d"

	api := ozeki.NewMessageApi(configuration)

	result := api.Delete(ozeki.Inbox, msg)

	fmt.Println(result)
}
	

الكود 1 - DeleteSms.go

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

يمكن استخدام مثال Go لرسائل SMS هذا في أي تطبيق Go. لاستخدامه، يجب عليك تنزيل حزمة github.com/ozekisms/go_send_sms_http_rest_ozeki. بعد تنزيل الحزمة، تحتاج إلى إضافة مرجع إليها في كود Go الخاص بك. سيسمح لك ذلك باستخدام الفئات المقدمة من حزمة github.com/ozekisms/go_send_sms_http_rest_ozeki. يمكنك استخدام فئة Message لإنشاء الرسالة القصيرة. يمكنك استخدام فئة MessageApi لإرسال الرسالة القصيرة إلى بوابة الرسائل القصيرة. ستقوم بوابة الرسائل القصيرة بإعادة توجيه رسالتك إلى شبكة الهاتف المحمول إما عبر اتصال لاسلكي أو عبر الإنترنت.

تنزيل DeleteSms.go

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

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

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

الشكل 2 - ما الموجود داخل DeleteSms.go.zip

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

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

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

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

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

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

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

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

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

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

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

import b64 "encoding/base64"

func (api *MessageApi) createAuthorizationHeader(username string, password string) string {
	var usernamePassword string = username + ":" + password
	var usernamePasswordEncoded string = b64.StdEncoding.EncodeToString([]byte(usernamePassword))
	return "Basic " + usernamePasswordEncoded
}
	

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

رأس طلب HTTP لإرسال رسالة SMS من Go

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

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

طلب HTTP لإرسال رسالة SMS من Go

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

POST /api?action=deletemsg HTTP/1.1
Content-Length: 73
Content-Type: application/json
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Go-http-client/1.1

{
	"folder": "inbox",
	"message_ids": [
		"4c53d0fa-646a-4402-8432-487afe141569"
	]
}
	

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

بمجرد أن يستقبل بوابة الرسائل القصيرة هذا الطلب، سيقوم بإنشاء استجابة 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: Fri, 09 Jul 2021 09:50:32 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
  
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "4c53d0fa-646a-4402-8432-487afe141569"
	  ]
	}
}
	

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

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

مثال Go لإرسال الرسائل القصيرة: DeleteSms.go

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

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

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

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

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

الختام

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

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

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

More information