ASP.NET основной веб-страниц с автоматической справки по API
В предыдущих версиях ASP.NET, когда я создавал Web Api 2, visual studio автоматически подключала автоматическую генерацию документации для API.
Это также объясняется здесь: http://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/creating-api-help-pages
Я пишу новый проект, и я решил сделать это с помощью ASP.NET ядро, но я не вижу ничего похожего на то, что существовало в предыдущих версиях, что генерирует документацию из API (я также предполагаю, что это немного отличается, так как все контроллеры теперь наследуют от одного и того же класса Controller).
Но, есть ли какой-то способ создать файлы справки для ASP.NET основные API?
2 ответа:
Функциональность, которую вы хотите, находится в https://github.com/domaindrivendev/Swashbuckle
По следующей ссылке приведен пример настройки и использования хорошо разработанной утилиты https://damienbod.com/2015/12/13/asp-net-5-mvc-6-api-documentation-using-swagger/
Джон Дэвидсон сделал хороший пост, показывающий, как создавать документацию Swagger-это полезно и здорово.
Но если вы хотите придерживаться ASP.Net MVC 5 - Api Explorer documentation, Вы должны взглянуть на этот превосходный пост в блоге:
Https://andrewlock.net/introduction-to-the-apiexplorer-in-asp-net-core/