aspnet api versioning

ASP.NET API -версии

Проверьте объявление о предстоящих изменениях

Проект «ASP» , более формально известный как версии ASP.NET API, дает вам мощный, но простой в использовании метод добавления семантики версий API в ваши новые и существующие службы REST, построенные с помощью ASP.NET. Расширения версий API определяют простые атрибуты метаданных и конвенции, которые вы используете для описания того, какие версии API реализуются вашими услугами. Вам не нужно изучать какие -либо новые концепции маршрутизации или менять способ реализации ваших услуг в ASP.NET сегодня.

Конфигурация версии версии API по умолчанию соответствует семантике выпуска версий, изложенной руководящими принципами Microsoft REST. Существует также ряд точек настройки и расширения, доступных для поддержки услуг перехода, которые, возможно, не поддерживали версии API в прошлом или поддерживаемые версии API с семантикой, которая отличается от рекомендаций Microsoft REST.

Поддерживаемые ароматы ASP.NET:

• ASP.NET CORE

  Добавляет версию API в ваши приложения ASP.NET Core Minimal API

• ASP.NET CORE MVC

  Добавляет версию API в ваши приложения ASP.NET CORE MVC (CORE)

• ASP.NET CORE и ODATA

  Добавляет версию API в ваши основные приложения ASP.NET с использованием ODATA V4.0

• ASP.NET WEB API

  Добавляет версии API в ваши приложения Web API

• ASP.NET WEB API и ODATA

  Добавляет версии API в ваши приложения Web API с использованием ODATA V4.0

Это также дом исследователей API API API API API, которые вы можете использовать, чтобы легко документировать API REST OpenAPI:

• ASP.NET CORE VERSIODED API Explorer

  Добавляет дополнительную поддержку API Explorer в ваши основные приложения ASP.NET

• ASP.net Core с Odata API Explorer

  Добавляет дополнительную поддержку API Explorer в ваши приложения ASP.NET Core с использованием ODATA V4.0

• ASP.net Web API Versioned API Explorer

  Заменяет исследователь API по умолчанию в ваших приложениях Web API

• ASP.net Web API с Odata API Explorer

  Добавляет API Explorer в ваши приложения Web API с использованием ODATA V4.0

Библиотеки на стороне клиента позволяют легко создавать клиентов HTTP-версии API.

• HTTP API API расширения версий

  Добавляет поддержку версий API к клиентам HTTP

Документация

Вы можете найти дополнительные примеры, документацию и инструкции по началу работы в вики.

Дискуссия

Есть общий вопрос, предложение или другие отзывы? Проверьте, как вы можете внести свой вклад.

Нормы поведения

Этот проект принял Кодекс поведения, определяемый Заветом участника, чтобы прояснить ожидаемое поведение в нашем сообществе. Для получения дополнительной информации см. Код поведения .NET .NET.

Лицензия

Этот проект лицензирован по лицензии MIT.

.Net Foundation

Этот проект поддерживается Фондом .NET.

---

Если вы существующий пользователь, убедитесь, что вы просмотрите заметки о выпуске между всеми основными и незначительными выпусками пакетов.

Логотип от Sacramento Design Works