.NET API - ما هي Web API ولماذا نستخدمها؟

.NET API - ما هي Web API ولماذا نستخدمها؟

Web API هي اختصار لـ Web Application Programming Interface، وهي وسيلة تتيح لتطبيقات مختلفة أن تتواصل وتتبادل البيانات من خلال بروتوكول HTTP.
فمثلًا، يمكن لتطبيق ويب أو تطبيق جوال أن يطلب بيانات من سيرفر باستخدام Web API ويرد السيرفر ببيانات بصيغة JSON أو XML.

---

ما الفرق بين Web API وMVC؟

في ASP.NET MVC، الهدف هو بناء صفحات HTML تعرض للمستخدم، بينما في ASP.NET Web API الهدف هو إرسال واستقبال بيانات (عادةً بصيغة JSON) بدون واجهة مرئية.

• MVC: يعرض صفحات HTML.
• API: يرسل ويستقبل بيانات فقط (بدون HTML).

---

أين نستخدم Web API؟

تُستخدم Web API في مواقف كثيرة منها:

• بناء تطبيق جوال يتواصل مع السيرفر لجلب البيانات.
• فصل الواجهة الأمامية (مثل React أو Blazor WebAssembly) عن الواجهة الخلفية.
• الربط بين الأنظمة المختلفة (مثل نظام نقاط البيع مع نظام المخزون).

---

ماذا نحتاج لبناء Web API؟

لبناء Web API باستخدام .NET نحتاج:

• Visual Studio أو Visual Studio Code
• ASP.NET Core SDK (يفضل آخر إصدار)
• قاعدة بيانات (مثل SQL Server أو SQLite)
• أداة لاختبار الـ API مثل Postman

---

مثال سريع على Controller بسيط

الكود التالي يوضح كيف يمكن إنشاء Web API ترجع قائمة من القيم:

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    [HttpGet]
    public IEnumerable<string> Get()
    {
        return new string[] { "Product 1", "Product 2", "Product 3" };
    }
}

---

ملخص الدرس

• Web API هي وسيلة للتواصل بين التطبيقات عبر الإنترنت.
• تُستخدم لإرسال واستقبال البيانات، وليس لعرض صفحات HTML.
• مفيدة لتطبيقات الجوال، الأنظمة الموزعة، والتطبيقات الحديثة التي تفصل بين الواجهة الأمامية والخلفية.

---

في الدرس القادم سنتعلم كيفية إنشاء مشروع Web API جديد باستخدام Visual Studio خطوة بخطوة 🔧