أدوات الاختبار: جولة داخل تطبيق Postman لإرسال أول طلب


يا هلا والله! اليوم بنتكلم عن أداة الكل يستخدمها تقريباً في مجال تطوير واختبار الـ APIs، وهي Postman. لو أنت مطور بك إذن تسمع عنها كثير، ولو أنت جديد في المجال، بتصير صديقك الصدوق.

وش هو Postman؟

ببساطة، Postman هو تطبيق يساعدك ترسل طلبات HTTP للـ APIs وتشوف الردود. يعني بدل ما تكتب كود كامل عشان تجرب API معين، Postman يسهل عليك الموضوع ذا بشكل كبير. تقدر تختبر GET, POST, PUT, DELETE وأي نوع طلب يخطر ببالك.

ملاحظة: Postman مو بس لإرسال الطلبات، فيه مميزات كثيرة زي حفظ الطلبات، تجميعها في مجموعات (Collections)، كتابة اختبارات آلية، وحتى مزامنة الشغل بين فريقك.

يلا نرسل أول طلب!

بعد ما تكون حملت Postman وثبته (العملية سهلة جداً، بس تدخل موقعهم وتحمل النسخة المناسبة لنظام تشغيلك)، نفتح التطبيق.

الخطوة 1: إنشاء طلب جديد

أول ما تفتح Postman، بتشوف واجهة بسيطة. عشان تسوي طلب جديد، اضغط على زر + أو New واختار HTTP Request. بتفتح لك تبويبة جديدة (tab) فاضية.

الخطوة 2: تحديد نوع الطلب والـ URL

في التبويبة الجديدة، بتشوف قائمة منسدلة لأنواع الطلبات (GET, POST, PUT, DELETE, إلخ). خليها على GET الحين. جنبها فيه مربع تكتب فيه الـ URL حق الـ API اللي تبغى تجربه. خلنا نجرب على API عام ومجاني عشان نشوف النتيجة. استخدم هذا الرابط:

https://jsonplaceholder.typicode.com/todos/1

هذا الـ API بيرجع لنا معلومات عن مهمة رقم 1.

الخطوة 3: إرسال الطلب

بعد ما حطيت الـ URL، اضغط على زر Send اللي لونه أزرق. وبس! Postman بيرسل الطلب للـ API.

الخطوة 4: مشاهدة الرد

مباشرة بعد ما تضغط Send، بتشوف قسم تحت مربع الـ URL بيعرض لك الرد (Response) اللي جاك من الـ API. غالباً بيكون بصيغة JSON. بتشوف شيء زي كذا:

{
  "userId": 1,
  "id": 1,
  "title": "delectus aut autem",
  "completed": false
}

هذا الرد يعني إن طلبك نجح، والـ API رجع لك بيانات المهمة رقم 1. بتشوف أيضاً معلومات زي Status Code (مثلاً 200 OK يعني كل شيء تمام) وكم أخذ الطلب وقت (Time).

وش بعد؟

هذي كانت مجرد بداية. في Postman تقدر تسوي أشياء كثيرة:

  • تغيير نوع الطلب لـ POST وإرسال بيانات في الـ Body.
  • إضافة Headers للطلب (زي الـ Authorization token).
  • حفظ طلباتك في Collections عشان ترجع لها بسهولة أو تشاركها مع فريقك.
  • كتابة Tests عشان تتأكد إن الرد اللي جاك صحيح.

نصيحة أخيرة: لا تخاف تجرب الأزرار والخيارات المختلفة في Postman. أفضل طريقة تتعلم فيها هي بالممارسة والتجربة. الـ documentation حقهم ممتاز ومفيد جداً.

أتمنى إن الشرح كان واضح ومفيد. بالتوفيق في رحلتك مع Postman!