« Previous 1 2 3
Swagger and OpenAPI Specification for documents
ElegantSpiceworks
Conclusions
The pages generated by the Swagger UI look pretty spartan and stand apart, at least visually, from the remaining documentation. Integration into existing online help requires a suitable redesign and major interventions. The information content also depends significantly on how extensively the provider specifies its service in the API description. Not least, the use of the Swagger UI pages is not always self-explanatory.
On the up side, the use of Swagger involves very little additional work, while facilitating access to the REST API for users or other developers. If you integrate the tools into your build process, you will benefit from constantly updated documentation, including a client SDK. Conversely, programmers can use Swagger to generate a client SDK quickly for a third-party REST API and save at least some typing. It could thus be worthwhile for all parties to take a look at Swagger and its associated tools.
Infos
- Swagger: http://swagger.io
- Swagger RESTful API document specification 2.0: http://swagger.io/specification/
- What is Swagger: http://swagger.io/getting-started/
- Jax-RS: https://jax-rs-spec.java.net
- Node.js: https://nodejs.org
- SmartBear: https://smartbear.com
- Open API Initiative: https://openapis.org
- OpenAPI Specification: https://github.com/OAI/OpenAPI-Specification
- Swagger Editor: http://editor.swagger.io
- Swagger Petstore example: http://petstore.swagger.io
- Watson Developer Cloud: https://watson-api-explorer.mybluemix.net
- Swagger codegen: https://generator.swagger.io
- Atlassian: https://de.atlassian.com
- RADAR: https://bitbucket.org/atlassian/radar
- Swagger Editor on GitHub: https://github.com/swagger-api/swagger-editor/releases
- Echo service: http://mazimi-prod.apigee.net/echo
- Graphical user interface in Swagger: https://github.com/swagger-api/swagger-ui/releases
- Swagger codegen on GitHub: https://github.com/swagger-api/swagger-codegen
- Swagger Core: https://github.com/swagger-api/swagger-core
« Previous 1 2 3
Buy this article as PDF
(incl. VAT)