.NET API - إنشاء مشروع ASP.NET Core Web API خطوة بخطوة

1.2 ‎.NET API - إنشاء مشروع ASP.NET Core Web API خطوة بخطوة

في هذا الدرس، سنتعلم كيفية إنشاء مشروع Web API باستخدام ASP.NET Core من البداية حتى تشغيل أول Endpoint. هنستخدم Visual Studio أو CLI حسب ما تفضل.

🛠️ الخطوة 1: إنشاء المشروع

افتح Visual Studio واختر:

• File ⮕ New ⮕ Project
• اختر ASP.NET Core Web API
• سم المشروع (مثلاً: MyApi)
• في صفحة الإعدادات، اختر:
  • ✅ .NET 6 أو أعلى
  • ✅ تعطيل HTTPS (اختياريًا للتجربة)
  • ✅ تمكين OpenAPI (Swagger)

أو يمكنك استخدام CLI:

dotnet new webapi -n MyApi

📁 هيكل المشروع الناتج

• Program.cs: نقطة البداية وتشغيل التطبيق.
• Controllers/WeatherForecastController.cs: مثال جاهز لـ API.
• appsettings.json: إعدادات المشروع (اتصال بقاعدة البيانات، مفاتيح... إلخ).

🚀 الخطوة 2: تشغيل المشروع

من Visual Studio، اضغط F5 أو شغّل المشروع من CLI:

cd MyApi
dotnet run

المتصفح سيفتح صفحة Swagger تلقائيًا:

https://localhost:5001/swagger

🔍 الخطوة 3: تجربة أول Endpoint

اذهب إلى /WeatherForecast من Swagger، واضغط Try it out ⮕ Execute، وستحصل على بيانات JSON عشوائية.

📌 ملاحظات مهمة

• ✔️ Web API في ASP.NET Core لا تحتاج إلى Views أو HTML.
• ✔️ Swagger أداة ممتازة لاختبار الـ API بدون الحاجة لـ Postman.
• ✔️ كل شيء يبدأ من Program.cs (أو Startup.cs في الإصدارات القديمة).