.NET Core - استخدام Postman لاختبار الـ APIs

5.2 .NET Core - استخدام Postman لاختبار الـ APIs

بعد إنشاء Web API في ASP.NET Core، تحتاج إلى أداة قوية لاختبار هذه الـ APIs قبل ربطها بتطبيق فعلي. وهنا يأتي دور Postman، وهي أداة مجانية وسهلة الاستخدام لإرسال الطلبات (Requests) واستعراض الردود (Responses).

---

🔹 ما هو Postman؟

Postman هو تطبيق لسطح المكتب أو المتصفح يُستخدم لاختبار RESTful APIs، يدعم أنواع مختلفة من الطلبات مثل: GET, POST, PUT, DELETE، ويعرض لك النتيجة بشكل منسق.

🔹 تحميل وتشغيل Postman

• اذهب إلى https://www.postman.com/downloads/
• قم بتنزيل الإصدار المناسب لنظام التشغيل لديك
• بعد التثبيت، شغّل البرنامج وأنشئ حسابًا (اختياريًا)

🔹 مثال عملي: اختبار API لإدارة المنتجات

📥 1) إرسال طلب GET:

GET https://localhost:5001/api/products

- اختر GET من القائمة العلوية - أدخل رابط API - اضغط Send 🔸 ستظهر لك قائمة المنتجات في قسم Response.

➕ 2) إرسال طلب POST (إضافة منتج):

POST https://localhost:5001/api/products
Content-Type: application/json

في تبويب Body → اختر raw → واكتب JSON:

{
  "name": "Tablet",
  "price": 1800
}

🔸 اضغط Send وستحصل على المنتج المضاف مع معرفه الجديد (Id).

📝 3) إرسال طلب PUT (تعديل منتج):

PUT https://localhost:5001/api/products/1

{
  "id": 1,
  "name": "Tablet Pro",
  "price": 2200
}

❌ 4) إرسال طلب DELETE:

DELETE https://localhost:5001/api/products/1

🔸 سيقوم هذا الطلب بحذف المنتج صاحب الـ Id = 1.

🔹 عرض التوكن في Authorization

لو كانت الـ API محمية بـ JWT، يمكنك الذهاب لتبويب Authorization ثم اختيار:

• Type = Bearer Token
• وضع التوكن في الحقل الخاص

🔹 الخلاصة

Postman أداة ممتازة لاختبار APIs قبل الدمج مع الواجهة الأمامية أو التطبيقات الأخرى. توفر تجربة سهلة ومرنة لتجربة جميع السيناريوهات، من CRUD إلى التوثيق باستخدام JWT.