آموزش ساختن Minimal API ها در ASP.NET Core 7 یکی دیگر از آموزش های گروه آموزشی پرووید می باشد که در این قسمت آن را به شما معرفی می کنیم. این بسته آموزشی نیز یکی از دوره های آموزشی دیگر که در حوزه فارسی سازی آموزش های انگلیسی تنظیم شده است می باشد. عنوان این بسته آموزشی، آموزش ایجاد کردن Minimal API ها در ASP.NET Core 7 است که با نام اصلی Building ASP.NET Core 7 Minimal API از شرکت Pluralsight منتشر شده است.

Minimal API چیست؟

Minimal API در ASP.NET Core یک رویکرد ساده و کم حجم برای ساخت وب‌سرویس‌ها است که با استفاده از آن می‌توان بدون نیاز به تنظیمات پیچیده و کد بیشتر، API هایی ساده و کارآمد را پیاده‌سازی کرد. این رویکرد جدید در نسخه‌های جدید ASP.NET Core معرفی شده است و به توسعه‌دهندگان امکان می‌دهد با کد کمتر، سرعت بیشتر و عملکرد بهتری برای وب‌سرویس‌های خود بدست آورند. با Minimal API می‌توان به راحتی روت‌ها، مدل‌ها و عملیات مربوط به API را تعریف کرده و برای ارتباط با دیگر سرویس‌ها و پایگاه‌داده‌ها از ویژگی‌ها و توابع موجود در ASP.NET Core استفاده کرد. این رویکرد ساده و مفیدی برای پیاده‌سازی وب‌سرویس‌های کوچک و ساده است که نیاز به پیچیدگی‌های بیشتری ندارند و امکان پیشرفته‌تر شدن و رشد به صورت پیوسته در آینده را فراهم می‌کند.

تفاوت Minimal API با Web API های معمولی در چیست؟

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

توسعه دادن Minimal API در ASP.NET Core

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

سرفصل مطالب آموزش ویدئویی ساختن Minimal API ها در ASP.NET Core 7

فصل اول: مقدمه این دوره آموزشی

• مقدمه این دوره آموزشی

فصل دوم: مقدمه‌ای بر Minimal API های ASP.NET Core

• بررسی ورژن برنامه این دوره آموزشی
• مقدمه
• پیش‌نیازهای این دوره آموزشی
• ابزارها
• ساخت API ها با ASP.NET Core
• معرفی برنامه استفاده شده در این آموزش
• آموزش عملی: ایجاد و بررسی یک پروژه ASP.NET Core Minimal API
• آموزش عملی: استفاده از Postman
• آموزش عملی: افزودن Data Layer
• جمع بندی

فصل سوم: آشنایی با مفاهیم اصلی و بررسی منابع

• مقدمه
• تزریق وابستگی در Minimal API ها
• آموزش عملی: تزریق وابستگی در Minimal API ها
• آشنایی با Routing
• آموزش عملی: کار کردن با الگو هایRouting
• چرا نباید Entity Model را منتشر کنیم؟
• آموزش عملی: افزودن DTO Model و استفاده از AutoMapper
• بررسی Parameter Binding
• آموزش عملی: Parameter Binding
• مدل سازی عملکرد مشترک API
• بررسی Status Code ها و ایجاد Response ‌ها
• آموزش عملی: ایجاد Response ‌های صحیح در API
• جمع بندی

فصل چهارم: کنترل کردن Response ‌ها

• مقدمه
• بررسی Routing بهبود یافته
• آموزش عملی: ایجاد یک Resource
• آموزش عملی: ایجاد کردن لینک ‌ها
• آموزش عملی: به‌روزرسانی Resource
• آموزش عملی: حذف Resource
• آموزش عملی: گروه‌بندی Resource ها
• مقایسه Negotiation در Minimal API ها
• اعتبارسنجی در Minimal API ها
• جمع بندی

فصل پنجم: ساختاردهی Minimal API شما

• مقدمه
• گزینه‌های ساختاردهی Minimal API ها
• آموزش عملی: توسعه IEndpointRouteBuilder برای ساختاردهیMinimal API شما
• جمع بندی

فصل ششم: مدیریت Exception ها و Logging

• مقدمه
• مدیریت Exception ها در Minimal API ها
• آموزش عملی: استفاده از Developer Exception Page Middleware
• آموزش عملی: استفاده از Exception Handler Middleware
• بهبود دادن Response های خطا با جزئیات
• آموزش عملی: بهبود دادن Response های خطا با جزئیات
• ثبت رویدادها در Minimal API ها
• آموزش عملی: ثبت رویدادها در Minimal API ها
• جمع بندی

فصل هفتم: پیاده سازی Business Logic با Endpoint Filterها

• مقدمه
• بررسی فیلترها برای Minimal API ها
• آموزش عملی: ایجاد Endpoint Filter Reusable
• آموزش عملی: ساخت Endpoint Filter Reusable قابل استفاده مجدد
• آموزش عملی: زنجیره‌بندی Endpoint Filter Reusable و اعمال آنها به یک Group
• آموزش عملی: اعمال Business Logic Depending به Response
• آموزش عملی: کنترل کردن Request Validation
• جمع بندی

فصل هشتم: ایمن کردن Minimal API شما

• مقدمه
• بررسی کلی امنیت API
• امنیت مبتنی بر توکن برای Minimal API ها
• آموزش عملی: نیاز به توکن Bearer
• تولید توکن
• آموزش عملی: تولید توکن با dotnet-user-jwts
• آموزش عملی: ایجاد و اعمال کردن یک Authorization Policy
• جمع بندی

فصل نهم: مستندسازی Minimal API شما

• مقدمه
• چند کلمه درباره Swagger OpenAPI
• آموزش عملی: پشتیبانی از OpenAPI با Swashbuckle
• آموزش عملی: افزودن Description ها و Summary ها
• آموزش عملی: بررسی Request Type ها و Status Code ها
• آموزش عملی: بررسی Request Type ها
• آموزش عملی: کنترل کردن OpenApiOperation
• بررسی امنیت API در Swagger
• جمع بندی