隨著應用的發展，API的路由與版本控制變得越來越重要。透過適當的路由設計與版本管理，我們可以保證API的穩定性與兼容性。本篇將介紹如何在ASP.NET Core中實現進階的API路由與版本控制策略。

1. API 路由的基礎概念

在ASP.NET Core中，路由是用來將HTTP請求映射到相應的控制器和操作方法。可以通過設定不同的路由來處理多樣化的API請求。例如，基本的路由配置可以在控制器上方添加[Route]屬性來實現：

[Route("api/[controller]")]
[ApiController]
public class ProductsController : ControllerBase
{
    [HttpGet]
    public IActionResult GetAllProducts()
    {
        // 獲取所有產品邏輯
        return Ok();
    }
}

這段代碼將GET請求映射到/api/products，並返回所有產品數據。

2. 進階路由設計：自訂路徑與動態參數

為了應對複雜的場景，我們可以使用自訂的路徑和動態參數來靈活配置API。例如，根據產品類別進行查詢：

[HttpGet("category/{categoryName}")]
public IActionResult GetProductsByCategory(string categoryName)
{
    // 根據類別獲取產品邏輯
    return Ok();
}

這樣的設計可以讓用戶通過/api/products/category/electronics來查詢指定類別的產品。

3. API 版本控制的重要性

當應用逐漸成熟並不斷更新時，API版本控制至關重要。它可以保證現有的API用戶在升級系統時不會受到影響。同時，新的功能和修改可以在新版本中實現，避免破壞性的變更。

在ASP.NET Core中，可以使用Microsoft.AspNetCore.Mvc.Versioning套件來輕鬆實現API版本控制。首先，在專案中安裝該套件：

dotnet add package Microsoft.AspNetCore.Mvc.Versioning

然後，配置版本控制：

public void ConfigureServices(IServiceCollection services)
{
    services.AddApiVersioning(config =>
    {
        config.DefaultApiVersion = new ApiVersion(1, 0);
        config.AssumeDefaultVersionWhenUnspecified = true;
        config.ReportApiVersions = true;
    });
}

接著，在控制器中使用[ApiVersion]屬性來定義不同版本的API：

[ApiVersion("1.0")]
[Route("api/v{version:apiVersion}/products")]
[ApiController]
public class ProductsV1Controller : ControllerBase
{
    [HttpGet]
    public IActionResult GetAllProductsV1()
    {
        // V1 API邏輯
        return Ok();
    }
}

這段代碼指定了V1版本的API，客戶端可以通過/api/v1/products來訪問該版本的資源。

4. 同時支持多個API版本

若需要同時支持多個版本的API，可以在控制器中為每個版本定義不同的邏輯。例如，V2版本可能會引入新的字段或變更返回結構：

[ApiVersion("2.0")]
[Route("api/v{version:apiVersion}/products")]
[ApiController]
public class ProductsV2Controller : ControllerBase
{
    [HttpGet]
    public IActionResult GetAllProductsV2()
    {
        // V2 API邏輯
        return Ok();
    }
}

這樣，我們可以同時支持v1和v2兩個版本的API，讓不同需求的用戶自由選擇。

5. 小結

透過進階的路由設計和API版本控制，我們可以保證API的穩定性和靈活性。這不僅提升了API的可維護性，也讓開發團隊能夠在不影響現有功能的情況下持續改進系統。利用ASP.NET Core的強大工具，實現高效的API管理變得更加簡單和直觀。