Documenting a SpringBoot REST API with OpenAPI 3 The main idea for documenting our back-end RESTful APIs is to communicate what our endpoints are doing to third-party developers. More info Benefits of using APIs: APIs provide information hiding. APIs provide Contracts.