Учебное пособие по документации API Swagger для начинающих — 1 — Введение в документацию API с Sw... скачать в хорошем качестве

Учебное пособие по документации API Swagger для начинающих — 1 — Введение в документацию API с Sw...

Ссылка на полный плейлист (13 видео)    • Swagger API documentation tutorial   Что такое Swagger? Цель Swagger™ — определить стандартный, не зависящий от языка программирования интерфейс для REST API, который позволяет как людям, так и компьютерам находить и понимать возможности сервиса без доступа к исходному коду, документации или посредством анализа сетевого трафика. При правильном определении через Swagger пользователь может понимать и взаимодействовать с удалённым сервисом, используя минимальное количество логики реализации. Подобно тому, как интерфейсы используются в низкоуровневом программировании, Swagger устраняет необходимость в догадках при вызове сервиса. С технической точки зрения, Swagger — это формальная спецификация, окружённая обширной экосистемой инструментов, которая включает в себя всё: от интерфейсов фронтенда до библиотек низкоуровневого кода и коммерческих решений для управления API. С чего начать? Если вы являетесь поставщиком API и хотите использовать Swagger для описания своих API, существует несколько подходов: Подход «сверху вниз», при котором вы используете редактор Swagger для создания определения Swagger, а затем используете встроенные инструменты Swagger Codegen для генерации серверной реализации. Подход «снизу вверх», при котором у вас есть существующий REST API, для которого вы хотите создать определение Swagger. Вы можете создать определение вручную (используя тот же редактор Swagger, упомянутый выше), или, если вы используете один из поддерживаемых фреймворков (JAX-RS, node.js и т. д.), вы можете получить автоматическую генерацию определения Swagger. Если вы используете JAX-RS, ознакомьтесь с примером по адресу https://github.com/swagger-api/swagge.... Если