Что такое OpenAPI Specification (OAS) 3.0 и чем она отличается от 2.0 (Swagger)?

OAS 3.0 — это современный стандарт описания REST API, пришедший на смену Swagger 2.0.

Ключевые отличия OAS 3.0:
1. Структура серверов: В 2.0 был один host и basePath. В 3.0 появился массив servers, где можно указать сразу несколько окружений (Dev, Stage, Prod) с разными URL.
2. Компоненты: Все переиспользуемые схемы, параметры и ответы переехали в единый блок components.
3. Поддержка Webhooks: Появился блок callbacks для описания асинхронных вебхуков.
4. Content Negotiation: Теперь можно описывать разные схемы тела запроса (Request Body) для разных Content-Type (например, один JSON для application/json и другой для multipart/form-data).