aspnet api versioning

Versión ASP.NET API

Consulte el anuncio sobre los próximos cambios

El proyecto "ASP" , más formalmente conocido como Versión API ASP.NET, le brinda un método potente pero fácil de usar para agregar semántica de versiones API a sus nuevos y existentes servicios de descanso construidos con ASP.NET. Las extensiones de versiones de API definen atributos y convenciones de metadatos simples que usa para describir qué versiones API implementan sus servicios. No necesita aprender ningún nuevo concepto de enrutamiento o cambiar la forma en que implementa sus servicios en ASP.NET hoy.

La configuración de versiones de API predeterminada cumple con la semántica de versiones descrito por las pautas de Microsoft REST. También hay una serie de puntos de personalización y extensión disponibles para admitir servicios de transición que pueden no haber admitido versiones de API en el pasado o compatibles con los versiones de API con semántica que son diferentes de las pautas de versiones de Microsoft REST.

Los sabores compatibles de ASP.NET son:

• ASP.NET Core

  Agrega versiones de API a sus aplicaciones API mínimas ASP.NET Core

• ASP.NET Core MVC

  Agrega versiones API a sus aplicaciones ASP.NET Core MVC (Core)

• ASP.NET Core y Odata

  Agrega versiones de API a sus aplicaciones Core ASP.NET utilizando ODATA V4.0

• API web ASP.NET

  Agrega versiones de API a sus aplicaciones de API web

• ASP.NET Web API y Odata

  Agrega versiones de API a sus aplicaciones de API web utilizando ODATA V4.0

Este es también el hogar de los exploradores de API de versiones ASP.NET API que puede usar para documentar fácilmente sus API REST con OpenAPI:

• ASP.NET Core Versioned API Explorer

  Agrega soporte de explorador API adicional a sus aplicaciones Core ASP.NET

• ASP.NET Core con ODATA API Explorer

  Agrega soporte de explorador API adicional a sus aplicaciones Core ASP.NET utilizando ODATA V4.0

• ASP.NET Web API Versión API Explorer

  Reemplaza el Explorador API predeterminado en sus aplicaciones de API web

• API web ASP.NET con ODATA API Explorer

  Agrega un explorador API a sus aplicaciones de API web utilizando ODATA V4.0

Las bibliotecas del lado del cliente simplifican la creación de clientes HTTP conscientes de la versión API.

• Extensiones de versiones de API de cliente HTTP

  Agrega soporte de versiones API a los clientes HTTP

Documentación

Puede encontrar ejemplos adicionales, documentación e instrucciones de inicio en el wiki.

Discusión

¿Tiene una pregunta general, sugerencia u otros comentarios? Vea cómo puede contribuir.

Código de conducta

Este proyecto ha adoptado el Código de Conducta definido por el Pacto de contribuyente para aclarar el comportamiento esperado en nuestra comunidad. Para obtener más información, consulte el Código de Conducta de la Fundación .NET.

Licencia

Este proyecto tiene licencia bajo la licencia MIT.

Fundación .NET

Este proyecto es compatible con la Fundación .NET.

---

Si es un usuario existente, asegúrese de revisar las notas de la versión entre todos los lanzamientos de paquetes principales y menores.

Logotipo de Sacramento Design Works