My experiments with Wordnik Swagger.
How To Use:
-
Install an Apache HTTP Server running on localhost:80
-
Symlink our Swagger Specification directory (api-spec) to the Apache service directory (/var/www/api-spec)
-
Verify the specification is being served:
-
Get yourself the Swagger UI from here: https://github.com/wordnik/swagger-ui
-
Change the properties in the Swagger UI src/main/html/index.html file, then rebuild Swagger UI:
discoveryUrl:"http://localhost:80/api-spec/api.json", apiKey:"", supportHeaderParams: true, supportedSubmitMethods: ['get', 'post', 'put', 'delete']
Build instructions on the Swagger UI Github homepage.
-
Symlink the rebuilt Swagger UI dist directory to /var/www/swagger-ui
-
Verify the Swagger UI is being served
-
Have a JBoss 7 instance running on port 8080
-
Build swagger-customer-api and deploy to JBoss 7 standalone
-
Verify the Swagger UI Try-It-Out feature by performing CRUD operations on the Customer resource.