این دوره به گونه‌ای طراحی شده است که دانش و مهارت‌های لازم برای ساخت، مدیریت و استقرار Web APIهای حرفه‌ای با استفاده از ASP.NET Core را به شما ارائه دهد. پس از اتمام دوره، قادر خواهید بود:

• ساخت و پیکربندی Web APIها: یاد می‌گیرید چگونه پروژه‌های API را از ابتدا ایجاد کرده و تنظیمات اولیه آن‌ها را انجام دهید. با ساختار پروژه‌های ASP.NET Core و فایل‌های پیکربندی کلیدی آشنا می‌شوید.
• درک عمیق مسیریابی (Routing): با انواع مسیریابی، از جمله attribute routing و convention-based routing آشنا شده و بهترین روش‌ها را برای طراحی URLهای API فرا می‌گیرید تا APIهایی قابل پیش‌بینی و استاندارد داشته باشید.
• پیاده‌سازی عملیات CRUD: نحوه استفاده از متدهای HTTP (GET, POST, PUT, DELETE) برای ایجاد، خواندن، به‌روزرسانی و حذف داده‌ها را به صورت عملی تجربه می‌کنید. این بخش شامل مثال‌های واقعی برای مدیریت منابع داده‌ای است.
• مدل‌سازی و اعتبارسنجی داده‌ها (Model Binding & Validation): چگونگی اتصال داده‌های ورودی درخواست به مدل‌های C# و اعتبارسنجی آن‌ها را برای اطمینان از صحت داده‌ها می‌آموزید. این شامل استفاده از Data Annotations و Fluent Validation است.
• مدیریت خطاها و استثناها: راهکارهای جامع برای مدیریت خطاهای API، از جمله بازگرداندن پاسخ‌های مناسب (مانند BadRequest، NotFound) و لاگ‌گیری خطاها برای عیب‌یابی بهتر را فرا می‌گیرید.
• احراز هویت و مجوزدهی (Authentication & Authorization): با پیاده‌سازی امنیت در APIها، از جمله استفاده از JWT (JSON Web Tokens) و سیاست‌های مجوزدهی مبتنی بر نقش یا ادعا، آشنا می‌شوید تا دسترسی به APIهای خود را کنترل کنید.
• تست و مستندسازی API: روش‌های مختلف تست کردن APIها (مانند Unit Testing و Integration Testing) و ابزارهایی مانند Swagger/OpenAPI برای مستندسازی خودکار و تعاملی API را یاد می‌گیرید.
• استقرار (Deployment) Web API: با گزینه‌های مختلف استقرار APIهای ASP.NET Core در محیط‌های مختلف، از جمله IIS، Docker یا سرویس‌های ابری مانند Azure App Service آشنا می‌شوید.
• بهترین شیوه‌ها و الگوهای طراحی: با رعایت اصول SOLID و سایر الگوهای طراحی، APIهای قابل نگهداری، مقیاس‌پذیر و با کارایی بالا می‌سازید که برای پروژه‌های بزرگ‌تر مناسب هستند.

شرکت در دوره “مبانی ASP.NET Core Web API Fundamentals” مزایای چشمگیری برای توسعه‌دهندگان به همراه دارد و شما را در مسیر شغلی خود یک گام به جلو می‌برد:

• افزایش مهارت‌های شغلی: با تسلط بر ASP.NET Core Web API، خود را به عنوان یک توسعه‌دهنده با دانش مدرن و مورد نیاز بازار کار مطرح می‌کنید. این مهارت‌ها در مصاحبه‌های شغلی و پیشرفت حرفه‌ای شما بسیار مؤثر خواهند بود.
• ایجاد پروژه‌های کاربردی: توانایی ساخت بک‌اندهای قدرتمند برای اپلیکیشن‌های وب، موبایل و دسکتاپ را پیدا می‌کنید که برای هر توسعه‌دهنده‌ای که قصد ساخت سیستم‌های متصل را دارد، حیاتی است.
• درک عمیق اکوسیستم .NET: این دوره نه تنها API بلکه بخش‌های مهمی از فریم‌ورک .NET Core را پوشش می‌دهد و درک شما را از این پلتفرم افزایش می‌دهد که به شما کمک می‌کند در سایر زمینه‌های .NET نیز قوی‌تر شوید.
• یادگیری از متخصصان: محتوای Pluralsight توسط متخصصان صنعت طراحی شده است که اطمینان از کیفیت بالا، به‌روز بودن مطالب و پوشش جامع بهترین شیوه‌ها را فراهم می‌کند.
• آمادگی برای پروژه‌های پیچیده‌تر: این دوره مبانی قدرتمندی را برای شروع کار بر روی پروژه‌های بزرگ‌تر و معماری‌های پیچیده‌تر، مانند میکروسرویس‌ها و سیستم‌های توزیع‌شده، ایجاد می‌کند.

برای بهره‌مندی حداکثری از این دوره و درک سریع‌تر مفاهیم، توصیه می‌شود که دانش اولیه در زمینه‌های زیر داشته باشید. البته، حتی بدون همه این پیش‌نیازها نیز می‌توانید دوره را دنبال کنید، اما ممکن است نیاز به مطالعه بیشتر در کنار آن داشته باشید:

• مبانی برنامه‌نویسی C#: درک مفاهیم اصلی C# مانند کلاس‌ها، اشیاء، متدها، انواع داده‌ها، حلقه‌ها، شرط‌ها و ساختارهای کنترل جریان ضروری است.
• آشنایی با پروتکل HTTP: آشنایی با درخواست‌ها و پاسخ‌های HTTP، متدها (GET, POST, PUT, DELETE)، و کدهای وضعیت HTTP (مثلاً 200 OK، 404 Not Found، 500 Internal Server Error) به شما کمک می‌کند تا نحوه کار APIها را بهتر درک کنید.
• مفاهیم اولیه .NET Core: اگرچه دوره از پایه شروع می‌شود و مفاهیم ASP.NET Core را توضیح می‌دهد، اما آشنایی کلی با اکوسیستم .NET Core و نحوه ساخت پروژه‌ها در آن مفید خواهد بود.
• مفاهیم اولیه پایگاه داده (اختیاری): اگرچه این دوره به طور عمیق به پایگاه داده نمی‌پردازد، اما آشنایی با مفاهیم SQL یا ORMها (مانند Entity Framework Core) درک شما را از بخش‌های مربوط به ذخیره‌سازی داده‌ها افزایش می‌دهد.

این دوره به صورت ماژولار و منطقی طراحی شده است تا یادگیری را گام به گام و سازمان‌یافته کند. سرفصل‌های اصلی که در این دوره به آن‌ها پرداخته می‌شود، عبارتند از:

• مقدمه و تنظیم محیط توسعه:

  شروع با آشنایی با ASP.NET Core Web API، معماری RESTful و تفاوت آن با ASP.NET Web API سنتی. سپس به نصب SDKهای لازم برای .NET Core، Visual Studio یا VS Code و ایجاد اولین پروژه خالی API می‌پردازید.

• ساخت اولین API و کنترلرها:

  معرفی عمیق‌تر کنترلرها (Controllers) و اکشن‌ها (Actions) در ASP.NET Core. پیاده‌سازی اولین متد GET برای بازگرداندن داده‌ها و استفاده از ابزارهایی مانند Postman یا Swagger UI برای تست درخواست‌ها و درک پاسخ‌ها.

• مسیریابی پیشرفته و Model Binding:

  بررسی دقیق‌تر Routing شامل Route Templates، Attribute Routing و استفاده از Route Constraints برای مدیریت دقیق‌تر مسیرها. همچنین، چگونگی دریافت و اتصال داده‌ها از URI، Body و Header درخواست با Model Binding به مدل‌های C# آموزش داده می‌شود.

• مدیریت داده‌ها با POST، PUT و DELETE:

  پیاده‌سازی متدهای POST برای ایجاد منابع جدید، PUT برای به‌روزرسانی منابع موجود و DELETE برای حذف آن‌ها. کار با DTOها (Data Transfer Objects) و تبدیل آن‌ها بین مدل‌های دامنه و مدل‌های API.

• اعتبارسنجی داده‌ها و مدیریت خطا:

  استفاده از Data Annotations و کتابخانه‌های قدرتمندی مانند Fluent Validation برای اعتبارسنجی ورودی‌ها و اطمینان از صحت داده‌ها. نحوه برخورد با خطاهای اعتبارسنجی و سایر استثناها و بازگرداندن پاسخ‌های خطای مناسب (مانند 400 Bad Request یا 404 Not Found).

• کار با داده‌ها (پایگاه داده و Entity Framework Core):

  ادغام API با پایگاه داده. معرفی Entity Framework Core به عنوان یک ORM (Object-Relational Mapper)، پیکربندی DbContext و انجام عملیات CRUD بر روی پایگاه داده. این بخش شامل مثال‌های عملی برای اتصال به SQL Server یا SQLite است.

• امنیت: احراز هویت و مجوزدهی:

  پیاده‌سازی امنیت در API. آموزش استفاده از JWT (JSON Web Tokens) برای احراز هویت و چگونگی پیاده‌سازی Role-based Authorization و Policy-based Authorization با استفاده از Attributeهای [Authorize] برای کنترل دسترسی کاربران به اکشن‌ها.

• نسخه‌بندی و مستندسازی API:

  بررسی اهمیت و روش‌های نسخه‌بندی API برای مدیریت تغییرات در طول زمان. معرفی ابزارهایی مانند Swagger/OpenAPI (از طریق Swashbuckle) برای تولید خودکار مستندات API و ایجاد یک رابط کاربری تعاملی برای تست APIها.

• تست و استقرار API:

  نوشتن تست‌های واحد (Unit Tests) و تست‌های یکپارچه‌سازی (Integration Tests) برای اطمینان از صحت عملکرد و پایداری API. سپس به گزینه‌های مختلف استقرار API، از جمله Docker و سرویس‌های ابری (مانند Azure App Service یا Heroku) پرداخته می‌شود.

• بهینه‌سازی و بهترین شیوه‌ها:

  معرفی مفاهیمی مانند Dependency Injection، Logging، Caching و Middlewareها. بررسی الگوهای طراحی متداول و نکاتی برای ساخت APIهای کارآمد، قابل نگهداری، و مقیاس‌پذیر در محیط‌های تولیدی.

یکی از نقاط قوت این دوره، تمرکز بر مثال‌های عملی و کدهای واقعی است که شما را قادر می‌سازد بلافاصله مفاهیم آموخته شده را به کار بگیرید. برای مثال، ساختار یک کنترلر ساده در ASP.NET Core Web API به شکل زیر است که عملیات CRUD را برای یک منبع فرضی مدیریت می‌کند:

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;

[ApiController]
[Route("api/[controller]")] // defines the base route for the controller
public class ProductsController : ControllerBase
{
    private readonly List<string> _products = new List<string> { "Laptop", "Mouse", "Keyboard" };

    // GET api/products
    [HttpGet]
    public ActionResult<IEnumerable<string>> Get()
    {
        return Ok(_products); // Returns 200 OK with the list of products
    }

    // GET api/products/1
    [HttpGet("{id}")]
    public ActionResult<string> Get(int id)
    {
        if (id < 0 || id >= _products.Count)
        {
            return NotFound(); // Returns 404 Not Found if product doesn't exist
        }
        return Ok(_products[id]);
    }

    // POST api/products
    [HttpPost]
    public ActionResult Post([FromBody] string value)
    {
        if (string.IsNullOrWhiteSpace(value))
        {
            return BadRequest("Product name cannot be empty."); // Returns 400 Bad Request
        }
        _products.Add(value);
        // Returns 201 Created with a link to the new resource
        return CreatedAtAction(nameof(Get), new { id = _products.Count - 1 }, value);
    }

    // PUT api/products/1
    [HttpPut("{id}")]
    public ActionResult Put(int id, [FromBody] string value)
    {
        if (id < 0 || id >= _products.Count)
        {
            return NotFound();
        }
        if (string.IsNullOrWhiteSpace(value))
        {
            return BadRequest("Product name cannot be empty.");
        }
        _products[id] = value;
        return NoContent(); // Returns 204 No Content for successful update
    }

    // DELETE api/products/1
    [HttpDelete("{id}")]
    public ActionResult Delete(int id)
    {
        if (id < 0 || id >= _products.Count)
        {
            return NotFound();
        }
        _products.RemoveAt(id);
        return NoContent(); // Returns 204 No Content for successful deletion
    }
}

در این مثال، می‌بینید که چگونه از Attributeهای [ApiController] و [Route] برای تعریف یک کنترلر و مسیر پایه آن استفاده می‌شود. متدهای [HttpGet]، [HttpPost]، [HttpPut] و [HttpDelete] عملیات مربوط به متدهای HTTP را مشخص می‌کنند. همچنین، استفاده از ActionResult یا ActionResult<T> برای بازگرداندن پاسخ‌های HTTP مناسب، از جمله بازگرداندن 201 Created در پاسخ به درخواست POST یا 204 No Content برای PUT و DELETE، آموزش داده می‌شود.

این دوره بر اهمیت API Design و پیروی از اصول RESTful تأکید دارد، که منجر به APIهایی قابل فهم، پایدار و قابل توسعه می‌شود. همچنین، مدیریت وابستگی‌ها (Dependency Injection) برای ساخت کدهای ماژولار و قابل تست، و استفاده از Middleware برای مدیریت درخواست‌ها و پاسخ‌ها در pipeline ASP.NET Core به طور مفصل توضیح داده خواهد شد.