RESTful Java Web Services - Third Edition

Summary

A number of RESTful web API metadata standards have emerged in the recent past. The objective of this chapter is to introduce you to some of the most popular RESTful web API documentation tools, namely WADL, RAML, and Swagger. This chapter is not meant for making any recommendations on choosing a documentation solution for your RESTful web application, but to help you understand the API documentation tools and their offerings in general. To choose the right solution for your organization, you should start by looking at the client applications that access the APIs and their usage pattern, and then choose a tool that makes the API consumption easier, which may eventually improve the adoption of APIs by the customers.

The next chapter ...