aspnet api versioning

Versão da API ASP.NET

Confira o anúncio sobre as próximas mudanças

O projeto "ASP" , mais formalmente conhecido como versão da API ASP.NET, oferece um método poderoso, mas fácil de usar, para adicionar a semântica de versão da API aos seus serviços de repouso novos e existentes construídos com o ASP.NET. As extensões de versão da API definem atributos e convenções simples de metadados que você usa para descrever quais versões da API são implementadas por seus serviços. Você não precisa aprender novos conceitos de roteamento ou mudar a maneira como implementa seus serviços no ASP.NET hoje.

A configuração padrão de versão da API é compatível com a semântica de versão descrita pelas diretrizes do Microsoft REST. Também existem vários pontos de personalização e extensão disponíveis para suportar serviços de transição que podem não ter suportado o versão da API no passado ou com o versão da API suportada com semântica que são diferentes das diretrizes de versão do Microsoft Rest.

Os sabores suportados do Asp.net são:

• ASP.NET CORE

  Adiciona versão da API ao seu ASP.NET Core Minimal API Applications

• ASP.NET CORE MVC

  Adiciona versão da API aos seus aplicativos ASP.NET Core MVC (Core)

• ASP.NET CORE e ODATA

  Adiciona versão da API aos seus aplicativos Core ASP.NET usando ODATA v4.0

• API da web asp.net

  Adiciona versão da API aos seus aplicativos de API da Web

• API da Web ASP.NET

  Adiciona versão da API aos seus aplicativos de API da Web usando OData v4.0

Este também é o lar dos exploradores de API de versão ASP.NET que você pode usar para documentar facilmente suas APIs de REST com o OpenAPI:

• ASP.NET Core Versioned API Explorer

  Adiciona suporte adicional do API Explorer aos seus aplicativos Core ASP.NET

• ASP.NET CORE com ODATA API Explorer

  Adiciona suporte adicional do API Explorer aos seus aplicativos Core ASP.NET usando ODATA v4.0

• API Web API API API Explorer de ASP.NET

  Substitui o API Explorer padrão em seus aplicativos de API da Web

• API da Web ASP.NET com ODATA API Explorer

  Adiciona um API Explorer aos seus aplicativos de API da Web usando OData v4.0

As bibliotecas do lado do cliente simplificam a criação de clientes HTTP da API Version-Ocree.

• Extensões de versão da API do cliente HTTP

  Adiciona suporte de versão da API aos clientes HTTP

Documentação

Você pode encontrar exemplos adicionais, documentação e instruções de início no wiki.

Discussão

Tem uma pergunta geral, sugestão ou outro feedback? Confira como você pode contribuir.

Código de Conduta

Este projeto adotou o Código de Conduta definido pelo Pacto Colaborador para esclarecer o comportamento esperado em nossa comunidade. Para obter mais informações, consulte o Código de Conduta da Fundação .NET.

Licença

Este projeto está licenciado sob a licença do MIT.

Fundação .NET

Este projeto é suportado pela fundação .NET.

---

Se você é um usuário existente, certifique -se de revisar as notas de lançamento entre todos os principais lançamentos de pacotes.

Logotipo de Sacramento Design Works