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基金会的支持。

---

如果您是现有用户，请确保查看所有专业和次要包装版本之间的发行说明。

萨克拉曼多设计作品的徽标