Best practices

OpenAPI Specification (OAS) includes requirements that, while not mandatory, are highly recommended. These requirements help tighten the API contract and make the use of API security tools more efficient. In addition, they also make using your API easier and more productive for API consumers, especially important when there are human users involved.

This section covers these best practices. Following them helps your APIs conform not just to the letter but also to the spirit of the OAS.