В этом разделе хочу показать примеры описания контрактов API, которые приходилось выполнять на разных проектах.
Разработка описания выполнялась в Swagger. Исходный код: openapi_example.yml Пример прошел успешную валидацию на swagger.io и на yamllint.com. Посмотреть вживую можно по этой ссылке: посмотреть пример.