...
- Server integration
- generating the swagger json on-the-fly. our REST api includes ".../api" endpoint to generate the json.
- It means that you need to add api documentation at your code by using annotation
- No server integration
- generating the swagger json file manually or
- generating the json automatically in compilation (build) by using 3rd party tools
- it can use same annotations mentioned #1 above, javadocs or JAX-RS annotation
- Brown Dog API - utilizing Swagger: https://bd-api-dev.ncsa.illinois.edu/docs/
Testing
Currently, BrownDog uses mostly Java and Scala to create REST API. We will test these languages and preferred-library first. The test results and notes will be posted here.
...