minnyfatty/aspnet-webapi

Ready to use preconfigured VS2017/VS2019 project to create fully functional production ready RESTful services with minimum frictions

ASP.Net WebApi2 Application with OWIN

Repository contains ready to use preconfigured project to create fully functional production ready RESTful services.

Note! If you are looking for a .Net Core project template, please, check out the project ASP.Net Core RESTful Service Project Template.

The template uses the 4.7.1 version of .Net Framework. Make sure that you have it installed before use the template.

Contains

• CORS enabled
• preconfigured HTTP OPTIONS handler
• Cache-Control header preconfigured
• Autofac as a DI-container
• Content formatter configured to use Json.Net
• AutoMapper
• Unhandled exceptions handler
• Unhandled exceptions logger
• Serilog as a default logger preconfigured to save logs to %AppData%/Logs folder
• Swagger for API documentation
• JWT-Bearer authentication to protect your API with IdentityModel
• Ability to use environment variables in configuration options (web.config)
• Support .env files to easy switching between different environments (DotNetEnv)
• ... and some other boilerplate code

Getting Started

1. Make sure you have the .Net Framework v4.7.1 installed
2. Install the extension from the Visual Studio Marketplace or download and install the latest version from the GitHub. Also, you can install it from Visual Studio. To do so click on "Tools/Extensions and Updates..." menu item, then select "Online/Visual Studio Marketplace/Templates" on the left pane, search for "ASP.Net WebAPI Application Project Template," select it and click "Download" button.
3. Restart Visual Studio
4. Click on "File/New Project..." menu item
5. Type "webapi" on the right pane
6. Select "APS.Net WebAPI Application With OWIN" and click OK button.
7. Run the service
8. Open a browser and navigate to http://localhost:5000/swagger/ui/index to see API documentation
9. Play around with the API

Visit project Wiki pages to learn more about the template.

Any suggestions and bug reports are very appeciated.