كيفية استخدام عميل بوستمان لإرسال الطلبات

إذا لم تكن معتادًا على Postman REST Client، فهو أداة قوية يستخدمها المطورون لاختبار وتوثيق واجهات برمجة التطبيقات (APIs). يوفر واجهة سهلة الاستخدام لإرسال طلبات HTTP، وتعيين المعلمات، وعرض الاستجابات.

في هذا الدليل، سنرشدك خلال عملية استخدام Postman كعميل REST لإرسال الطلبات إلى واجهة برمجة التطبيقات. سنغطي كيفية إعداد Postman، كيفية إنشاء الطلبات، كيفية تعيين رؤوس الطلبات والمعلمات، وكيفية عرض وتحليل الاستجابات.

ما هو Postman REST Client؟

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

ما هو عميل Postman؟

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

يسمح Postman للمستخدم بالوصول إلى بروتوكولات المصادقة دون إنشاء نسخ احتياطية. يدعم عميل Postman بروتوكولات AWS وHawk Authentication وOAuth 2.0. يمكن للمستخدم إدارة ملفات تعريف الارتباط وكذلك الشهادات. تُستخدم ملفات تعريف الارتباط التي يرسلها الخادم عند إرسال طلب لبعض الطلبات الأخرى. يدعم عميل Postman العديد من الشهادات مثل شهادات SSL وشهادات CA ودعم شهادة العميل.

يعتبر عميل Postman أكثر من مجرد عميل REST. يمكنه مساعدة المطورين في إنشاء مقتطفات من التعليمات البرمجية بعدة لغات. كما يحتفظ بسجل الطلبات، ويمكن كتابة الاختبارات في Postman Sandbox. تساعد الاختبارات المطور في بناء طلبات أفضل. ما بدأ كعميل REST تطور ليقدم تجربة أفضل للمستخدمين.

كيفية استخدام Postman كعميل REST لإرسال الطلبات

يمكن لـ Postman إنشاء وإرسال الطلبات إلى خادم الويب الذي يرسل استجابة. لا يحتاج المستخدم إلى إجراء خطوات إضافية لإعداد الإطارات لإنشاء أو إرسال أو استلام الطلبات باستخدام Postman.

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

الخطوات العامة لاستخدام Postman:

قم بتنزيل عميل Postman

قم بتنزيل وتثبيت عميل Postman من الموقع الرسمي على Chrome (https://www.postman.com/downloads/) لنظام التشغيل الخاص بك.

قم بتشغيل التطبيق بعد التثبيت وأنشئ حسابًا أو قم بتسجيل الدخول للبدء في استخدام التطبيق إذا كان لديك حساب بالفعل.

بعد إنشاء حساب، انقر على شروط الاتفاق، وسيظهر لك تنبيه لفتح التطبيق على سطح المكتب. سيتم الترحيب بك نافذة ترحيب تطلب منك ملء اسمك ودورك كمطور. بمجرد تحديدها، سيتم عرض نافذة مثل هذه:

يمكنك الآن البدء باستخدام Postman!

إنشاء طلب

يمكنك إنشاء طلب عن طريق اختيار طريقة HTTP (GET، POST، PUT، DELETE) لطلب واجهة برمجة التطبيقات. ثم تحتاج إلى ملء URL الخاص بالنقطة النهائية التي تريد التفاعل معها وتحديد الرؤوس والجسم والمعلمات المطلوبة للطلب. إذا كانت واجهة برمجة التطبيقات تتطلب مصادقة، يجب عليك تكوين تفاصيل المصادقة.

إرسال الطلب

انقر على زر الإرسال لتنفيذ طلب واجهة برمجة التطبيقات. سيقوم Postman بإرسال الطلب إلى النقطة النهائية وتوليد استجابة.

عرض الاستجابة

سيظهر Postman الاستجابة المستلمة من الخادم. يمكنك عرض رمز الحالة، الرأس، الجسم، نتائج الاختبار، وملفات تعريف الارتباط. يمكن عرض جسم الاستجابة بعدة تنسيقات، بما في ذلك (JSON، XML، والبيانات الخام) لفهم أفضل من المطور أو المختبر.

الاختبار والأتمتة

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

البيئة والمتغيرات

يمكنك استخدام البيئات لإدارة المتغيرات التي يمكن استخدامها لإدارة الطلبات من خلال تحديد متغيرات محددة للبيئة مثل URLs والرموز. يمكنك أيضًا التبديل بين البيئات لتحسين العمل مع تكوينات مختلفة.

التوثيق

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

Apidog: منصة أفضل لواجهات برمجة التطبيقات من عميل Postman

ما هو Apidog؟

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

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

الميزات في Apidog

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

يساعد في "التصميم أثناء التصحيح"، مما يتيح للمطورين تصحيح أخطاء واجهات برمجة التطبيقات أثناء العمل على تعديلاتهم في الوقت نفسه. تساعد "إضافة Apidog IDEA" المطورين الخلفيين على دمج المواصفات من تعليقات Javadoc بدون الحاجة إلى التعليق. ميزة أخرى مفيدة في Apidog تشمل "الاتصال بقاعدة البيانات"، التي تتيح استرجاع البيانات مباشرة من قواعد البيانات مثل MySQL، Oracle، MongoDB، إلخ.

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

مع ميزاته المتقدمة، اكتسب Apidog بسرعة شهرة بين المطورين. إنه من بين منصات واجهة برمجة التطبيقات الرائدة.

كيف يعمل Apidog؟

التثبيت:

افتح موقع Apidog (https://apidog.com/)، الذي سيعطيك خيار التنزيل. بعد التنزيل، قم بتثبيت التطبيق على جهازك، أو استخدم موقع Apidog لإنشاء واجهات برمجة التطبيقات عبر الإنترنت.

إنشاء حساب:

بعد تثبيت التطبيق، يجب عليك إنشاء حساب أو تسجيل الدخول إلى حساب موجود.

بعد إنشاء الحساب، ستظهر لك نافذة ترحيبية تطلب منك اختيار دورك كمطور.

إنشاء واجهة برمجة التطبيقات

يمكنك اختيار إنشاء مشروع جديد لبناء واجهة برمجة تطبيقات. ستحتاج إلى اختيار نوع المشروع كـ HTTP أو gRPC. بمجرد بدء المشروع، يمكنك اختيار إنشاء واجهة برمجة التطبيقات.

إرسال طلب

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

فحص الاستجابات

يمكنك عرض رمز حالة الاستجابة، والجسم، والرأس، والمعالجة المسبقة، والمعالجة اللاحقة، وملفات تعريف الارتباط الخاصة بالاستجابة من الخادم. يمكن رؤية جسم الاستجابة في العديد من التنسيقات، مثل JSON/XML.

اختبار واجهة برمجة التطبيقات الخاصة بك

في Apidog، يمكنك اختيار وإنشاء عدة سيناريوهات اختبار وعرض تقارير الاختبار لتلك السيناريوهات. يتطلب إضافة سيناريو اختبار جديد اسم السيناريو، والأولوية، والوصف فيما يتعلق بحالة الاختبار.

بعد إضافة اختبار، يمكنك القيام بخطوات الاختبار وإضافة التكامل المستمر والتسليم.

يمكن للمطور أيضًا عرض تقارير الاختبار لفهم نتائج الاختبار بشكل أفضل وتحسين واجهات برمجة التطبيقات.

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

التعاون

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

الخلاصة

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