معماری Web API

۱. معماری لایه‌بندی

• کنترلرها
• سرویس‌ها
• ریپوزیتوری‌ها

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly IProductService _service;
    public ProductsController(IProductService service)
    {
        _service = service;
    }
}

۲. اصول RESTful

• HTTP Verbs
• کدهای وضعیت
• endpointهای معنادار

۳. امنیت

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddJwtBearer(options => {
    options.TokenValidationParameters = new TokenValidationParameters
    {
        ValidateIssuer = true,
        ValidateAudience = true
    };
});

۴. مدیریت خطا

• Middleware
• پیام‌های خطا
• لاگ‌گیری

۵. مستندسازی

/// دریافت لیست محصولات
[HttpGet]
[ProducesResponseType(200)]
public IActionResult Get()

۶. تست‌پذیری

• Unit Test
• Integration Test
• Postman

منابع

• مستندات Microsoft
• کتاب‌های آموزشی