aspnet api versioning

ASP.NET API版本

查看有關即將進行更改的公告

“ ASP”項目，更正式地稱為ASP.NET API版本，為您提供了一種功能強大但易於使用的方法，用於在使用ASP.NET構建的新的和現有的REST服務中添加API版本使用語義。 API版本掌握擴展定義了您用來描述哪些API版本的簡單元數據屬性和約定。您無需學習任何新的路由概念，也不需要改變您今天在ASP.NET中實現服務的方式。

默認的API版本控製配置符合Microsoft REST指南概述的版本控制語義。還有許多自定義和擴展點可用於支持過去可能不支持API版本的過渡服務或支持與Microsoft REST版本指南不同的語義的API版本控制。

ASP.NET的支持口味是：

• ASP.NET核心

  將API版本化添加到您的ASP.NET核心最小API應用程序

• ASP.NET核心MVC

  將API版本化添加到您的ASP.NET Core MVC（Core）應用程序

• ASP.NET核心和ODATA

  使用ODATA v4.0添加ASP.NET核心應用程序中的API版本控制

• ASP.NET Web API

  將API版本化添加到您的Web API應用程序

• ASP.NET Web API和ODATA

  使用ODATA v4.0向您的Web API應用程序添加API版本控制

這也是ASP.NET API版本控制API資源管理器的所在地，您可以使用OpenAPI輕鬆記錄REST API：

• ASP.NET核心版本為API Explorer

  在您的ASP.NET核心應用程序中添加其他API Explorer支持

• ASP.NET核心與ODATA API Explorer

  使用ODATA v4.0向您的ASP.NET核心應用程序添加其他API Explorer支持

• ASP.NET Web API版本為API Explorer

  替換Web API應用程序中的默認API資源管理器

• 帶有ODATA API Explorer的ASP.NET Web API

  使用ODATA v4.0向您的Web API應用程序添加API Explorer

客戶端庫使創建API版本感知的HTTP客戶端變得簡單。

• HTTP客戶端API版本傳播擴展

  向HTTP客戶端添加API版本支持

文件

您可以在Wiki中找到其他示例，文檔和入門說明。

討論

有一個一般的問題，建議或其他反饋嗎？查看如何貢獻。

行為守則

該項目採用了貢獻者盟約定義的行為準則，以闡明我們社區的預期行為。有關更多信息，請參見.NET基金會行為守則。

執照

該項目已根據MIT許可獲得許可。

.NET基金會

該項目得到了.NET基金會的支持。

---

如果您是現有用戶，請確保查看所有專業和次要包裝版本之間的發行說明。

薩克拉曼多設計作品的徽標