Documenting an API is important for its successful adoption. APIs expose data and services that consumers want to use. An API should be designed with an interface that the consumer can understand. API documentation is key to the app developers comprehending the API. The documentation should help the developer learn about the API functionality and enable them to use it easily.
This chapter looks at the aspects of documenting an API and some tools and technologies available for API documentation, including RAML, OpenAPI, API Blueprint, ...
