OpenAPI — это спецификация для описания RESTful API, которая позволяет стандартизировать описание интерфейсов веб-сервисов. Swagger же изначально был инструментом и экосистемой для работы с API, включая генерацию документации, клиентских SDK и серверных заглушек.

В 2016 году спецификация Swagger была переименована в OpenAPI Specification (OAS) и передана в управление Linux Foundation под эгидой OpenAPI Initiative. Сейчас OpenAPI — это стандарт, а Swagger — набор инструментов, поддерживающих этот стандарт.

Обычно используют последнюю стабильную версию OpenAPI Specification, на момент 2024 года это OpenAPI 3.1.x, так как она поддерживает более гибкое описание, включая полную совместимость с JSON Schema.

Пример использования OpenAPI 3.1:

Чем OpenAPI отличается от Swagger? Какую версию используете?