6.4 API Documentation
The last level of documentation we want to introduce in this chapter is API documentation and, specifically, the documentation of a web service’s REST API. When developing web applications, you usually have a natural break between frontend and backend. The endpoints of the backend provide read and write interfaces for the frontend. Frontend and backend are often implemented by different teams, sometimes even by different companies. For this reason, clear and proper communication is of great importance at this point.
The OpenAPI Specification, also known under its former name, Swagger, is widely used for documenting REST APIs. Depending on the platform used, you describe the interfaces of your application in a separate ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access