HelpPage для ASP.NET vNext MVC 6 Web Api

В настоящее время я просматриваю asp.net vnext MVC6 в Visual Studio 2015 Preview. Я новичок в asp.net в целом, но в моей компании мы собираемся перейти к созданию веб-api, используя asp.net для доступа к данным на нашем сервере (в настоящее время мы поддерживаем только связь wcf с нашим собственным приложением silverlight). Именно по этой причине я проверяю новые функции MVC 6, чтобы судить о том, следует ли ждать до начала разработки и использования MVC 6, когда он наконец-то выпущен или начнет разработку сейчас, и создаст проект Web API 2.

В любом случае, я изучаю автоматическую документацию веб-api, которая уже интегрирована в шаблон Visual Studio для проекта WebApi 2 с помощью Microsoft.AspNet.WebApi.HelpPage.

Теперь для моего вопроса, что-то вроде этого доступно для MVC 6? Я могу импортировать один и тот же пакет в проекте project.json в моем проекте ASP.NET vNext/MVC6 (все, что вы хотите назвать), но я не могу сделать app.UseHelpPage(); в моем файле Startup.cs.

Я подозреваю, что это еще не интегрировано в текущую версию. Если нет, есть ли какие-либо сведения об интеграции этой функции после того, как ASP.NET vNext в конечном итоге попадет на полки?

Ответ 1

Вероятно, эта функция пока недоступна в MVC 6, но вы можете попробовать Swagger. Swagger - это основа для описания, потребления и визуализации API RESTful. Самое приятное в Swashbuckle, что он не зависит от ASP.NET MVC, поэтому нет необходимости включать какие-либо пакеты MVC Nuget для включения документации по API, а также Swashbuckle содержит встроенную версию swagger-ui, которая автоматически будет обслуживать после установки Swashbuckle.

Источник: http://bitoftech.net/2014/08/25/asp-net-web-api-documentation-using-swagger/