كيفية استخدام Postman لاختبار واجهة برمجة تطبيقات Ozeki SMS Gateway

يشرح هذا البرنامج التعليمي كيفية استخدام Postman لاختبار مختلف استدعاءات واجهة برمجة التطبيقات HTTP/JSON/REST التي توفرها Ozeki SMS Gateway. باتباع الخطوات في هذا الدليل، ستقوم بتنزيل أداة اختبار واجهة برمجة التطبيقات Postman، وإنشاء طلبات واجهة برمجة تطبيقات نموذجية، وإرسال رسالة SMS اختبارية باستخدام Postman. كما سترى الرد الذي تعيده Ozeki SMS Gateway لطلب واجهة برمجة التطبيقات.

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

واجهة برمجة التطبيقات (API)، أو Application Programming Interface، هي مجموعة من القواعد والبروتوكولات لبناء البرامج والتطبيقات والتفاعل معها. تتيح واجهات برمجة التطبيقات لأنظمة البرامج المختلفة التواصل مع بعضها البعض، مما يتيح للمطورين استخدام وظائف وإجراءات محددة مسبقًا للتفاعل مع نظام أو تطبيق أو خدمة.

لاستخدام Postman لاختبار واجهة برمجة تطبيقات Ozeki SMS Gateway

1. تثبيت Ozeki SMS Gateway
2. تنزيل منصة Postman API
3. فتح Ozeki SMS Gateway
4. تثبيت مستخدم HTTP في Ozeki SMS Gateway
5. تشغيل Postman
6. إنشاء حساب في Postman
7. إضافة طلب جديد في Postman
8. إدخال عنوان URL للطلب
9. النقر على إرسال
10. عرض الرد المستلم في Postman
11. التحقق من علامة التبويب "الأحداث" في Ozeki SMS Gateway لرؤية الطلب المستلم
12. عرض الرسالة في مجلد "المرسلة" في Ozeki SMS Gateway

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

في الصفحة الرئيسية لـ Ozeki، انتقل إلى لوحة "المستخدمون والتطبيقات" الموجودة على الجانب الأيمن من الشاشة. انقر على "إضافة مستخدم/تطبيق جديد"، المشار إليه بالسهم الأحمر في الصورة (الشكل 1). سيؤدي هذا الإجراء إلى فتح قائمة حيث يمكنك إدخال التفاصيل اللازمة لإنشاء مستخدم أو تطبيق جديد. إضافة مستخدم HTTP أمر بالغ الأهمية لاختبار واجهة برمجة تطبيقات Ozeki SMS Gateway.

سترى قائمة بأنواع المستخدمين، ابحث عن عنصر تثبيت "مستخدم HTTP" في قائمة تثبيت مستخدمي الشبكة. انقر على رابط تثبيت بجوار عنصر تثبيت مستخدم HTTP (الشكل 2). سيبدأ هذا عملية تثبيت حساب مستخدم HTTP، مما يتيح لك إرسال رسائل إلى نظامك باستخدام طلبات HTTP GET و HTTP POST.

بعد ذلك، تحت علامة التبويب "عام"، أدخل اسم المستخدم و كلمة المرور المطلوبين لمستخدم HTTP الجديد (الشكل 3). بعد التأكد من صحة اسم المستخدم وكلمة المرور، انقر على زر "موافق" للمتابعة في إنشاء حساب المستخدم. سيؤدي هذا الإجراء إلى إتمام الإعداد وتثبيت مستخدم HTTP الجديد في النظام.

بمجرد إنشاء مستخدم HTTP، سيتم توجيهك إلى صفحة تفاصيل المستخدم حيث يمكنك عرض معلومات مختلفة حول المستخدم كما هو موضح في الشكل 4. على سبيل المثال، يمكنك التحقق من الأحداث، واختبار طلبات HTTP Post، وتغيير اسم المستخدم وكلمة المرور، وقراءة الوثائق، وعرض رسائل SMS الواردة والصادرة.

رابط التنزيل:

https://www.postman.com/downloads/

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

كيفية تنزيل مثبت Postman

لبدء تثبيت برنامج Postman، افتح متصفح الويب الخاص بك وأدخل رابط التنزيل في شريط العنوان. بمجرد تحميل الصفحة، قم بالتمرير لأسفل للعثور على مثبت Windows 64-bit على الجانب الأيسر. انقر على الرابط لبدء تنزيل مثبت البرنامج كما هو موضح في الشكل 5.

بعد انتهاء التنزيل، حدد موقع قسم التنزيلات في متصفحك (عادة ما يكون سهمًا صغيرًا يشير لأسفل في الزاوية اليمنى العليا)، هذا هو المكان الذي ستجد فيه ملف المثبت لـ Postman. انقر على زر 'فتح الملف' لبدء تثبيت منصة Postman API.

عملية التثبيت تتم تلقائيًا بمجرد فتح ملف المثبت، كل ما عليك فعله هو الانتظار حتى تنتهي (الشكل 7). بعد اكتمال التثبيت، سيتعين عليك تسجيل حساب Postman، إذا لم يكن لديك واحد بالفعل. يوفر Postman واجهة سهلة الاستخدام وميزات قوية تجعل من السهل إرسال واستقبال طلبات HTTP، والتي تُستخدم للتحقق من وظائف إعداد بوابة الرسائل القصيرة الخاصة بك.

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

بمجرد فتح نافذة المتصفح، سترى حقولًا على الجانب الأيمن لـ 'اسم المستخدم' و'كلمة المرور'. قم بتعيين اسم مستخدم وكلمة مرور قوية لحسابك. أدخل معلومات سهلة التذكر ولكنها آمنة في هذه الحقول. بعد ملء هذه التفاصيل، انقر على زر 'إنشاء حساب مجاني' لإنهاء عملية التسجيل (الشكل 9).

في الخطوة التالية، سيتم توجيهك إلى صفحة مختلفة تطلب منك إدخال اسمك ودورك الوظيفي. املأ مربع النص 'اسمك' باسمك واختر دورك من القائمة المنسدلة تحت 'ما هو دورك؟' (الشكل 10). بعد تقديم هذه المعلومات، حدد موقع وانقر على زر 'متابعة' للمتابعة. تساعد هذه الخطوة Postman في تخصيص التجربة لتلبي احتياجاتك وتفضيلاتك بشكل أفضل، مما يعزز سير عمل اختبار واجهات برمجة التطبيقات الخاصة بك.

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

يُظهر هذا الفيديو القصير الذي مدته 39 ثانية كيفية إرسال طلب HTTP GET باستخدام Postman لاختبار واجهة برمجة تطبيقات Ozeki SMS Gateway. بدءًا من لوحة تحكم Postman الرئيسية، سوف تتعلم كيفية إضافة طلب جديد وإرساله إلى مستخدم HTTP الذي تم إنشاؤه في Ozeki SMS Gateway. ستكتشف أيضًا كيفية التحقق من الرسالة المستلمة في Ozeki SMS Gateway وعرض تفاصيل الرسالة. يضمن هذا الفيديو السريع والواضح أنه يمكنك اختبار طلبات واجهة برمجة التطبيقات الخاصة بك بسهولة وكفاءة.

لإنشاء طلب جديد، ما عليك سوى النقر على زر '+' كما هو موضح في الشكل 12. سيؤدي هذا إلى بدء عملية إنشاء طلب API جديد في Postman. من هنا، ستتمكن من تكوين تفاصيل الطلب، مثل طريقة HTTP وعنوان URL والرؤوس والجسم، لاختبار واجهة برمجة تطبيقات Ozeki SMS Gateway الخاصة بك بشكل فعال.

إدراج عنوان URL للطلب

لإجراء الاختبار، سنستخدم طلب HTTP GET. ابدأ بتحديد مربع النص الخاص بعنوان URL في واجهة Postman، كما هو موضح في الشكل 13. أدخل عنوان URL لطلبك في هذا المربع. يمكنك العثور على مثال للطلب في 'الخطوة 4 - مثال للطلب' إذا قمت بالتمرير لأسفل. تأكد من استبدال اسم المستخدم وكلمة المرور في الطلب باسم المستخدم وكلمة المرور التي قمت بتعيينها عند إنشاء مستخدم HTTP.

بعد تنفيذ الخطوات السابقة بشكل صحيح، انقر على زر إرسال الأزرق الموجود في الزاوية العلوية اليمنى من واجهة Postman. (الشكل 14) هذا الإجراء سيرسل طلب HTTP GET إلى بوابة Ozeki SMS، مما يسمح لك باختبار وظيفة API والتأكد من أن إعداداتك تعمل كما هو متوقع.

إذا نجح طلب HTTP GET، فستتلقى استجابة يمكن عرضها في الجزء السفلي من واجهة Postman. يُشار إلى نجاح الطلب بكود حالة 0 ورسالة حالة تقول "تم قبول الرسالة للتسليم." (الشكل 15) هذا التأكيد يعني أن الرسالة قد تم إرسالها بالفعل عبر بوابة Ozeki SMS.

للتحقق من نجاح طلب HTTP GET في بوابة Ozeki SMS، انتقل إلى علامة التبويب 'الأحداث'، كما هو موضح في الشكل 16. هنا، يجب أن ترى الإدخال المسمى "تم قبول الإرسال"، مما يؤكد نجاح الطلب. هذه الخطوة تضمن أن الرسالة لم يتم إرسالها فقط ولكن تم استلامها ومعالجتها بشكل صحيح بواسطة بوابة SMS.

لعرض الرسالة المرسلة في بوابة Ozeki SMS، قم بالتمرير لأسفل على الجانب الأيسر حتى تصل إلى قسم جدول التحكم 'المجلدات'. انقر على مجلد 'المرسلة'، كما هو موضح في الشكل 17. هذا الإجراء سيفتح قائمة حيث يمكنك رؤية قائمة بالرسائل التي تم إرسالها. هنا، ستتمكن من العثور على رسالة اختبار API.

مثال للطلب

https://127.0.0.1:9508/api?command=SendMessage&Username=ht1&Password=qwe123& Recipient=06203105366&MessageType=SMS:TEXT&MessageData=Hello+World&responseformat=json

مثال للاستجابة

{
	"response": {
		"action": "sendmessage",
		"data": {
			"acceptreport": {
				"statuscode": 0,
				"statusmessage": "Message accepted for delivery",
				"messageid": "a79af012-741b-4272-ba59-427524f2e546",
				"recipient": "06203105366",
				"messagetype": "SMS:TEXT",
				"messagedata": "Hello World"
			}
		}
	}
}

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

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

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

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

لتلخيص الأمر

لقد بذلنا قصارى جهدنا لجعل الأمر بسيطًا وشرح جميع التفاصيل بأسهل طريقة ممكنة. باتباع التعليمات أعلاه، يمكنك إنشاء الحل بسرعة. الآن يمكنك اختبار واجهة برمجة تطبيقات بوابة Ozekي للرسائل القصيرة. لقد رأيت المزايا التي يمكن أن تقدمها بوابة Ozekي للرسائل القصيرة. إذا كنت ترغب في اكتشاف المزيد من المعلومات القيمة حول فوائد الحلول المشابهة الأخرى، يرجى زيارة ozeki-sms-gateway.com.