«Основы OpenAPI, разбираемся со Swagger»

Курс «Инструменты: Postman, Swagger, Сниферы»: https://systemanalyst.life/postmanswa...

Сегодня разбираем Swagger и OpenAPI простыми словами: что это такое, в чём разница между OpenAPI и Swagger, и почему системному аналитику (и не только) важно уметь читать и писать спецификацию — даже если у вас уже есть ТЗ в Confluence/Word.

На вебинаре шаг за шагом посмотрим:
зачем аналитику “лезть” в OpenAPI, если есть требования
что такое YAML, какие у него базовые правила (отступы, ключ-значение, списки, вложенность)
какие корневые объекты OpenAPI обязательны (openapi, info, paths)
как описать GET-методы, ответы 200 / 404 / 500, и path-параметр (например, {id})
как работает Swagger Editor и Swagger UI, где посмотреть ошибки и как быстро проверить спецификацию
какие темы мы не успеваем на вебинаре (components, security, requestBody, схемы, allOf/oneOf/anyOf, теги, серверы) и почему они важны

В конце — кратко рассказываю про курс «Инструменты: Postman, Swagger, Сниферы», как он устроен, что внутри (много практики, домашки без тестов), и какие бонусы доступны участникам вебинара.

Кому будет полезно
✅ Системным аналитикам (junior/middle), кто работает с API и интеграциями
✅ Тем, кто видит в вакансиях “Swagger/OpenAPI” и хочет уверенно отвечать на собеседованиях
✅ Тем, кто хочет понимать документацию API, тестировать запросы и общаться с разработчиками на одном языке


Таймкоды:

00:00 - Введение в вебинар
03:08 - Причины выбора темы
04:05 - Определение OpenAPI
05:01 - Определение Swagger
06:00 - Разница между OpenAPI и Swagger
06:54 - Демонстрация Swagger Editor
07:49 - Структура документации в Swagger
09:25 - Использование документации Swagger
10:45 - Зачем аналитику работать с OpenAPI
13:02 - Генерация сервиса по REST API
14:31 - Подходы к генерации документации
15:04 - Преимущества OpenAPI
16:21 - YAML
28:51 - Сравнение JSON и YAML
30:39 - Корневые элементы OASIS
32:50 - Описание openapi
33:41 - Описание info
38:32 - Описание path
40:36 - Примеры операций
43:06 - Компоненты и ссылки
44:39 - Описание кодов ответов
48:09 - Исправление ошибок
49:26 - Обзор структуры API
50:24 - Детали метода get
51:33 - Схема и её роль
52:12 - Введение и обсуждение сложности
53:06 - Описание второго примера
54:03 - Шаги описания в Swagger
55:01 - Детали описания метода `get`
57:57 - Описание параметров
01:00:41 - Детали описания параметра `id`
01:01:58 - Завершение примера
01:04:24 - Вопросы и ответы
01:07:37 - Заключение
01:15:56 - Курс "Инструменты для аналитика"