luca
New Contributor
Joined 6 years ago
User Profile
User Widgets
Contributions
Re: Webservice that allows any POST argument
Sorry, I dont' understand your answer. This is the content of my JSON Swagger declaration: "/Log/Insert":{ "put":{ "summary":"Insert generic logs", "operationId":"insertLog", "consumes":[ "application/x-www-form-urlencoded" ], "produces":[ "text/plain" ], "responses":{ "200":{ "description":"successful operation", "schema":{ "type":"integer", "format":"int64" } } } } }, what "request body" are you refering to? Thank you.1.1KViews0likes0CommentsWebservice that allows any POST argument
Hello, I have a POST webservice that actually allows the user to send any kind of argument, in the form key1=value1&key2=value2&key3=value3... where key1,key2, key3 are not known before. I would like to know if this is supported by Swagger specification protocol. If this matters, the webserver is developed with Java EE (JAX-RS), with Swagger 1.5.21.1.2KViews0likes4Comments[newbie] how to generate static docs with maven?
Hello, I have a Java JAX-RS webservice, built with Maven. The webservice runs in Thorntail (i.e. JBoss), if that matters. Now, I cannot understand how to use Swagger exactly. I already know how to annnotate classes properly. I want to generate some HTML (not JSON or YAML!) static documentation of my webservices. Something similar to https://petstore.swagger.io. Possibly, I want to do that using Maven. I have seen there is a third-party Maven plugin (https://github.com/kongchen/swagger-maven-plugin), however I would like to avoid third-party products. I have found two interesting plugins, but I did not understand how to use them, nor if they are available in Maven Central Repository: https://github.com/swagger-api/swagger-core/tree/master/modules/swagger-maven-plugin https://github.com/swagger-api/swagger-codegen/tree/master/modules/swagger-codegen-maven-plugin So, what is the intended way to generate docs? Thank you.