Спецификация OpenAPI предоставляет один из способов описания REST API и включает все разделы, упомянутые в предыдущем разделе Документирование конечных точек API. Фреймворки, такие как Swagger UI, могут анализировать спецификацию OpenAPI и генерировать интерактивную документацию, которая позволяет пользователям опробовать точки доступа при изучении API.
Обзор форматов спецификаций REST API
Знакомство со спецификациями OpenAPI и Swagger
Практическое занятие: Создание спецификации OpenAPI
Введение и руководство SwaggerHub
Stoplight - инструмент визуального моделирования для создания спецификаций