1. Swagger (commonly known as: Stockings elder brother) What is the thing?
Swagger is a normative and complete framework for generating, describing, invoking, and visualizing RESTful Web services. The overall goal is to have the client and the file system update at the same speed as the server. File methods, parameters and models are tightly integrated into the server-side code, allowing the API to always stay in sync. Swagger making deployment management and using powerful APIs has never been easier.
2. What can I do with my stockings?
A. Interface, service visualization, very clear, easy to use
B. Do interface test, easy for testers to use
3.Swagger how to integrate with WEBAPI?
First step: Create a WEBAPI project
Step two: Introduce the swagger package (swashbuckle, swagger two)
Step Three: Open the solution Properties--build, tick the XML document file, save
Swagger will be saved to the bin directory under the current appdomaim after the XML comment document is generated for display on the UI
Fourth step: Find the Registration method for the Swaggerconfig file, remove this code from the comment below to load the generated XML document on the UI
The Getxmlcommentspath method is implemented as follows: Read the path to the comment file
private static string Getxmlcommentspath () { return string. Format ("{0}/bin/webapiswaggerdemo.xml", System.AppDomain.CurrentDomain.BaseDirectory); }
Fifth step: Open the Swggernet file and comment out the following two lines of code (it is estimated that the code in the NuGet package is not updated causing the exception to occur)
Sixth step: Swagger has been integrated successfully, in the browser input: Http://localhost:37033/swagger/ui/index can see the interface
Seventh step: Develop your own API module
<summary>/ //Update order information/ //</summary>//<param name= "input" ></param> // /<returns></returns> [HttpPost, Route ("Order/updateorder")] public Outputresult UpdateOrder ( Businessmodel input) { return new Outputresult () {Success = false, Message = "Congratulations on your update order success!" " }; }
Specify the routing address Order/updateorder and access mode Post/get/put
Eighth Step: Test Call
Through Swaggerui you can browse and test the list of interfaces through your Comtroller module
This is too convenient for the internal use of the company, all the APIs can be used for development and testing to invoke, but it should be noted that the production environment is still to do permissions control, because the post and put method can directly manipulate the database.
The company has been using, but there is no time to summarize and share, recently written down hope to help everyone.
WEBAPI Integrated Swagger