Swagger что это сленг

Слово «swagger». Англо-русский словарь Мюллера

He was a short, thick-set man, with coarse, commonplace features, and that swaggering air of pretension which marks a low man who is trying to elbow his way upward in the world.

Это был невысокий коренастый человек с грубыми, маловыразительными чертами лица. Он держал себя с наглостью и напыщенностью, свойственными людям, которые, не стесняясь в средствах, пробивают себе путь к успеху.

He stood before her, holding himself easily, but with a gallant swagger.
Он стоял перед ней непринужденно, однако с некоторым самодовольным изяществом.
That’s called the bipedal swagger.
Это называется двуногий хвастун.

Примеры использования

It was mere swagger and challenge; but in this particular, as in many others, blustering assertion goes for proof, half over the world.

У него было только фанфаронство и наглость; но и в этом случае, как и во многих других, беззастенчивое бахвальство может сойти за доказательство в глазах большинства.

Rosie liked his devil-may-care attitude toward life, the swagger with which he wore clothes made by the best tailor in London and unpaid for, the recklessness with which he would put a fiver he hadn’t got on a horse, and the generosity with which he flung his money about when a lucky win put him in funds.

Рози нравилось, как легко он относится к жизни, как лихо носит свои костюмы, сшитые у лучшего портного Лондона и неоплаченные, как безрассудно может поставить на какую-нибудь лошадь пять фунтов, которых у него нет, и как щедро швыряет деньги направо и налево, если выиграет.

There was an ease in his manner—a gay and light manner it was, but not swaggering—which I still believe to have borne a kind of enchantment with it.

В его обращении с людьми была какая-то простота, какая-то веселая, но отнюдь не развязная непринужденность, которая – я и теперь так думаю – просто очаровывала.

Примеры использования

Strange Chinese hung out of windows, digging the Sunday night streets; groups of Mex chicks swaggered around in slacks; mambo blasted from jukeboxes; the lights were festooned around like Halloween.

Из окон высовывались поглазеть на вечерние воскресные улицы странного вида китайцы. Важно расхаживали мексиканочки в брючках, из музыкальных автоматов гремели звуки мамбо. Словно в канун Дня Всех Святых, все было увешано гирляндами огней.

Even when he isn’t laughing, that laughing sound hovers around him, the way the sound hovers around a big bell just quit ringing — it’s in his eyes, in the way he smiles and swaggers, in the way he talks.

Теперь он не смеется, но смех еще дрожит вокруг него, как звук продолжает дрожать в только что отзвонившем большом колоколе, – он в глазах, в улыбке, в дерзкой походке, в голосе.

You wave an airy adieu to the boys on shore, light your biggest pipe, and swagger about the deck as if you were Captain Cook, Sir Francis Drake, and Christopher Columbus all rolled into one.

Вы весело машете рукой друзьям, оставшимся на берегу, закуриваете самую длинную свою трубку и гордо разгуливаете по палубе с таким видом, словно вы капитан Кук, сэр Фрэнсис Дрэйк и Христофор Колумб в одном лице.

Примеры использования

That’s called the bipedal swagger.
Это называется двуногий хвастун.

Примеры использования

Everyone pointed to Maria and said how lovely she was, how talented; they praised her to her face as she swaggered in her cape.

Все указывали на Марию и говорили, как она красива и талантлива; ее расхваливали на все лады, а она расхаживала с важным видом, щеголяя своим нарядным плащом.

‘Sir’—you will salute and ‘sir’ anyone who carries an instructor’s baton — » He was carrying a swagger cane and now made a quick reverse moulinet with it to show what he meant by an instructor’s baton; I had noticed men carrying them when we had arrived the night before and had intended to get one myself — they looked smart.

Вы отдаете честь и говорите «сэр» всем, у кого в руках инструкторский жезл, — и он помахал стеком, чтобы дать понять, что именно он назвал «жезлом». Еще прошлой ночью я увидел подобные стеки у некоторых людей и немедленно воспылал желанием раздобыть себе такой же, уж больно круто выглядели эти палки.

His thickset torso was supported by short sturdy legs, always incased in the finest leather boots procurable and always planted wide apart like a swaggering small boy’s.

Этот могучий торс держался на двух коротких, но чрезвычайно крепких ногах, неизменно обутых в сапоги из самой лучшей кожи и столь же неизменно широко расставленных, как у задиристого мальчишки.

SWAGGER

amble, arrogance, barge, bluff, bluster, bluster and bluff, blustering, boast, boastfulness, boasting, bombast, bounce, bowl along, brag, braggadocio, braggartism, bragging, brandish, bravado, brave show, bully, bullying, bundle, bustle, clump, cock, conceit, crow, cut a swath, display, drag, draw the longbow, drifter, droop, fanfaronade, flaunt, flounce, flourish, flurry, fluster, foot, footslog, fuss, gait, gallop, gasconade, gasconism, halt, hector, hectoring, heroics, hippety-hop, hitch, hobble, hobo, hop, intimidate, intimidation, jactation, jactitation, jog, jolt, jump, limp, lock step, lumber, lunge, lurch, mince, mincing steps, ostentation, out-herod Herod, pace, paddle, parade, peacock, peacockery, peacockishness, peg, piaffe, piaffer, plod, pontificate, prance, prink, puff, rack, rage, rant, rave, roadster, rodomontade, roister, roll, rollick, sashay, saunter, scuff, scuffle, scuttle, shack, shamble, show, show off, shuffle, side, sidle, single-foot, skip, slang, slink, slither, slog, slouch, slowness, speak for Buncombe, splutter, sputter, stagger, stalk, stamp, step, stomp, storm, straddle, straggle, stride, stroll, strolling gait, strut, strutting, stump, sundowner, swaggering, swagman, swank, swash, swashbuckle, swashbucklering, swashbucklery, swashbuckling, swell, swing, tittup, toddle, totter, traipse, traveler, tread, trip, trot, trudge, vanity, vapor, vaunt, vauntery, vaunting, velocity, waddle, walk, wamble, wiggle, wobble

swagger [ˊswægə]
1) чванли́вая и самодово́льная мане́ра держа́ться, похо́дка и т.п.
2) развя́зность

1) расха́живать с ва́жным ви́дом (тж. swagger about, swagger in, swagger out ); ва́жничать; чва́ниться

2) хва́стать (about)
3. a разг. щегольско́й, наря́дный, шика́рный

1. сущ. 1) чванливая и самодовольная манера держаться, походка и т. п. 2) развязность A man who has outgrown the swagger and affectations of boyhood, and settled down into a respectable member of society. — Человек, освободившийся от ребяческой развязности и манерности и ставший респектабельным членом общества. Syn: undue familiarity 2. гл. 1) расхаживать с важным видом (тж. swagger about, swagger in, swagger out); важничать; чваниться He swaggered about like an aide-de-camp at a review. — Он расхаживал с важным видом, как адъютант на параде. Syn: walk 2) хвастать 3) действовать (на кого-л.) угрозами и т. д. He would swagger the boldest men into a dread of his power. — Он нагонит страху на самых храбрых людей. 4) шататься, качаться 3. прил.; разг. нарядный, роскошный, шикарный, щегольской Sir Charles was a notable figure in swagger society. — Сэр Чарльз был заметной фигурой в высшем обществе. Syn: foppish, dandified

swagger
1. [ʹswægə] n тк. sing 1. преисполненная важности и самодовольства походка, манера и т. п.
to walk with a ~ — расхаживать с важным видом
2. развязность
I don‘t like his ~ — мне не нравятся его развязные манеры
3. бахвальство
2. [ʹswægə] a разг. щегольской, нарядный, шикарный
~ society — шикарное общество
3. [ʹswægə] v 1. расхаживать с важным видом (тж. ~ about. ~ in, ~ out); важничать
he ~ed in as if he owned the place — он вошёл с таким (важным) видом, будто весь дом принадлежал ему
2. воздействовать (на кого-л.) угрозами, давлением и т. п.
to ~ a person into dread — нагнать на кого-л. страху
to ~ smb. out of opposition — сломить чьё-л. сопротивление
3. (about) хвастать(ся) (чем-л.)
don‘t you start ~ing about it — только не начинай хвастать этим

Перевод «swagger» на русский

Gere’s character in the film is the personification of smooth and cool with his distinctive fashion style and swagger.

Характер Гира в фильме является олицетворением гладкого и прохладного с его отличительным стилем моды и чванством.

We wanted to bring in a rough-and-tumble former cohort of Agent Coulson with a little bit of attitude and cigar-smoking swagger.

Мы хотели привнести в сериал безумного бывшего коллегу Агента Коулсона с небольшим налетом чванства и курения сигары.

What we absolutely dig about Matthew Woodward is his swagger.
Что мы абсолютно копаем в Мэтью Вудворде, так это его чванство.
Days before the Sochi meetings, both Trump and Putin took care to show their swagger.

За несколько дней до встречи в Сочи и Трамп, и Путин позаботились о том, чтобы показать своё чванство.

We might as well swagger into the city.
Так что возможно, мы запустимся и в этом городе».
Look at that swagger and bravado.
А теперь взгляните на этого крепко-сколоченного и угрюмого бугая.
To have the swagger we deserve.
К сожалению мы имеем тот ютьюб, который заслуживаем.
He put on his best vocal swagger.
Он играет в в свой лучший снукер.
They swagger for a while, then they become extinct.
Со временем они наклоняются, что впоследствии приводит к их падению.
Now, the swagger appears to have returned.
Но, кажется, теперь Слендер вернулся.

Having always played by their own rules, their pioneering legacy continues to venture into the unknown with unbridled confidence and swagger.

Они всегда играли в эту игру по своим правилам, и их новаторское начало продолжает двигаться в неизвестность с необузданной уверенностью и пижонством.

And they swagger and they throw rocks.
А еще они важничают и кидаются камнями.
Возможно неприемлемое содержание

Примеры предназначены только для помощи в переводе искомых слов и выражений в различных контекстах. Мы не выбираем и не утверждаем примеры, и они могут содержать неприемлемые слова или идеи. Пожалуйста, сообщайте нам о примерах, которые, на Ваш взгляд, необходимо исправить или удалить. Грубые или разговорные переводы обычно отмечены красным или оранжевым цветом.

Зарегистрируйтесь, чтобы увидеть больше примеров. Это просто и бесплатно
Ничего не найдено для этого значения.
Предложить пример
Больше примеров Предложить пример

Новое: Reverso для Windows

Переводите текст из любого приложения одним щелчком мыши .

Скачать бесплатно
Перевод голосом, функции оффлайн, синонимы, спряжение, обучающие игры

Результатов: 453 . Точных совпадений: 453 . Затраченное время: 61 мс

Помогаем миллионам людей и компаний общаться более эффективно на всех языках.

Swagger: что это такое и как с ним работать?

Для взаимодействия с любой программой используется API. Он может быть закрытым для внешнего взаимодействия или открытым. В любом случае разработчикам следует уделять внимание его спецификации. Это в том числе нужно для того, чтобы новые члены команды быстрее и проще вовлекались в проект.

Детям из Мариуполя нужно 120 ноутбуков для обучения — подари старое «железо», пусть оно работает на будущее Украины

Ручное формирование документации — утомительное занятие. Поэтому разработчики придумали Swagger. С его помощью на основе кода можно автоматически сгенерировать спецификации API.

Что такое Swagger?

Swagger — это набор инструментов, которые помогают описывать API. Благодаря ему пользователи и машины лучше понимают возможности REST API без доступа к коду. С помощью Swagger можно быстро создать документацию и отправить ее другим разработчикам или клиентам.

В 2015 году проект Swagger сделали открытым и передали OpenAPI Initiative. Теперь сама спецификация называется OpenAPI. Swagger — инструментарий для работы с OpenAPI, название которого используется в коммерческих и некоммерческих продуктах. Если кто-то называет саму спецификацию Swagger, то это не совсем верно.

Курс Аналітик даних.

Протягом 4 місяців ви вивчите повний набір інструментів для аналізу даних та отримаєте можливість працевлаштування в Laba Group.

Документ спецификации OpenAPI использует YAML, но также может быть написан в формате JSON. Сам по себе он является объектом JSON.

Получить высокий уровень знаний в разработке, можно закончив курсы наших партнеров школы Mate Academy. Менторство у практикующих экспертов и индивидуальный подход выведут вас на высокий профессиональный уровень.

Основные подходы

Swagger предлагает два основных подхода к генерированию документации:

Автогенерация на основе кода.

Первый подход проще. Мы добавляем зависимости в проект, конфигурируем настройки и получаем документацию. Сам код из-за этого может стать менее читабельным, документация тоже не будет идеальной. Но задача минимум решена — код задокументирован.

Чтобы пользоваться вторым подходом, нужно знать синтаксис Swagger. Описания можно готовить в формате YAML/JSON. Можно упростить эту задачу, используя Swagger Editor. Конечно, второй подход позволяет сделать документацию более качественной и кастомной для каждого конкретного проекта и его особенностей, к тому же все не так сложно как может показаться, это потребует минимальных дополнительных усилий.

Swagger Core

Это Java-реализация спецификации. Для ее использования потребуется:

Курс Англійської.
Онлайн-навчання англійської за методикою Кембриджу — вибір понад мільярда людей.

Для его внедрения в проект используются две зависимости. Вот примеры:

 io.swagger.core.v3 swagger-annotations 2.1.11  org.springdoc springdoc-openapi-ui 1.5.2  

Другой способ — настроить maven-плагин. Тогда описания при сборке проекта будут генерироваться в файл YAML. Пример:

 org.springdoc springdoc-openapi-maven-plugin 0.3  integration-test generate    http://localhost:3080/v3/api-docs openapi.yaml $  

Для конфигурации нужны еще два бина (beans). В них мы описываем название приложения, версию API, добавляем другие важные данные. Посмотреть примеры можно в этом репозитории на GitHub . В нем представлены образцы Swagger Core из библиотеки Java. Каждый образец содержит файл Readme , в котором подробно описано, как его запускать и что проверять.

После настройки конфигурации мы получим аннотации, которые можно использовать для документирования кода.

Аннотация	Использование
@Operation	Для описания операции или метода HTTP
@Parameter	Для представления одного параметра в операции
@RequestBody	Для представления тела запроса в операции
@ApiResponse	Для представления тела ответа в операции
@Tag	Для представления тегов операции или определения OpenAPI
@Server	Для представления серверов операции или определения OpenAPI
@Callback	Для описания набора запросов
@Link	Для представления ссылки времени разработки для ответа
@Schema	Для определения входных и выходных данных
@ArraySchema	Для определения входных и выходных данных для типов массивов
@Content	Для представления схемы и примеров для мультимедиа
@Hidden	Для скрытия ресурса, операции или свойства

Swagger Codegen

Это проект для автоматического генерирования клиентских библиотек API, заглушек сервера и документации. Поддерживает большое количество технологий. Посмотреть полный список можно в репозитории Swagger Codegen на GitHub.

В этом же репозитории вы найдёте примеры того, как можно генерировать документацию, используя различные шаблоны.

API клиенты	ActionScript, Ada, Apex, Bash, C#, C++, Clojure, Dart, Elixir, Elm, Eiffel, Erlang, Go, Groovy, Haskell, Java (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured), Kotlin, Lua, Node.js, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust (rust, rust-server), Scala (akka, http4s, swagger-async-httpclient), Swift (2.x, 3.x, 4.x, 5.x), Typescript
Заглушки	Ada, C# (ASP.NET Core, NancyFx), C++ (Pistache, Restbed), Erlang, Go, Haskell (Servant), Java (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, RestEasy, Play Framework, PKMST), Kotlin, PHP (Lumen, Slim, Silex, Symfony, Zend Expressive), Python (Flask), NodeJS, Ruby (Sinatra, Rails5), Rust (rust-server), Scala (Finch, Lagom, Scalatra)
Генераторы документации	HTML, Confluence Wiki
Файлы конфигурации	Apache2
Другое	JMeter для нагрузочного тестирования

Плюсы Swagger Codegen:

Генерирование серверов — позволяет избавиться от рутины, создавая шаблонный код на 20+ языках.

Курс Англійської.
Подолай мовний бар’єр та розширюй коло друзів на розмовних клубах.

Чтобы добавить Swagger Codegen в проект, используйте зависимость:

 io.swagger.codegen.v3 swagger-codegen-maven-plugin 3.0.24  

Как и в случае с Swagger Core, можно настроить maven-плагин для генерации клиента или мок-сервера.

 org.openapitools openapi-generator-maven-plugin 3.3.4  compile generate  spring $/src/main/resources/api.yaml 
$/generated-sources
 com.api com.model ApiUtil.java $ $ $ true swagger spring-mvc true true java8 true  $/.openapi-generator-ignore     

Swagger Codegen предоставляет следующие команды:

• Config-help — помощь с настройкой выбранного языка.
• Generate — генерирование кода с выбранным генератором.
• Help — вывод справочной информации про openapi-generator .
• List — список доступных генераторов.
• Meta — генератор набора шаблонов и настроек Codegen. Использует информацию о выбранном языке.
• Validate — проверка спецификации.
• Version — отображение используемой версии.

Самые полезные команды — generate и validate . Первая позволяет создать клиент, а вторая — проверить его соответствие спецификации. Посмотреть полный список возможностей можно с помощью команды help после запуска jar-файла.

Swagger UI

Swagger UI визуализирует ресурсы OpenAPI и взаимодействие с ними без отображения логики реализации. Этот инструмент берет спецификацию и превращает ее в интерактивный проект, где можно выполнять разные запросы для тестирования API.

Плюсы Swagger UI:

• Нет зависимостей. Интерфейс доступен в любой среде разработки.
• Полная поддержка браузерами.
• Удобное взаимодействие для других разработчиков и клиентов. Можно проверить все операции, предоставляемые API, даже не имея специальных знаний.
• Простая навигация. Ресурсы и конечные точки представлены в виде аккуратно распределенного на категории списка.
• Можно настраивать стиль и пользовательский интерфейс так, как вам хочется.

Пользовательский интерфейс Swagger полностью размещен в SwaggerHub . Вы можете написать и визуализировать API или импортировать существующие определения для создания интерактивного интерфейса, размещенного в облаке. Благодаря встроенной интерактивности SwaggerHub позволяет безопасно предоставлять доступ к документации внешним пользователям или другим разработчикам.

Swagger Editor

Это онлайн-редактор для изменения и проверки API внутри браузера. Позволяет просматривать документацию в реалтайме. С его помощью можно создать описания, а затем использовать их с полным набором инструментов для генерации документации.

Плюсы Swagger Editor:

• Работает в любой среде разработки, локально и в сети.
• Дает обратную связь — показывает ошибки в синтаксисе по мере написания, проверяя его на соответствие OpenAPI.
• Позволяет мгновенно визуализировать API через Swagger UI.
• Помогает писать документацию быстрее благодаря интеллектуальному автозаполнению.
• Предоставляет гибкие инструменты для настройки конфигурации — от темы оформления до межстрочного интервала.
• Предлагает создание серверных заглушек и клиентских библиотек для вашего API на всех популярных языках.

Верхний уровень спецификации OpenAPI 3.0 содержит восемь объектов. Внутри этих верхнеуровневых объектов есть много вложенных объектов. Давайте далее последовательно рассмотрим все объекты верхнего уровня.

Первое и самое важное свойство в документации. Объект содержит информацию о спецификации OpenAPI. Пример:

В объекте info содержится основная информация об API: заголовок, описание, версия, ссылки на лицензию, обслуживание, контактные данные. Не все свойства обязательны к заполнению.

info: title: "My API" description: "Get anything" version: "1.1" termsOfService: "https://terms" contact: name: "API" url: "https://api" email: "[email protected]" license: name: "CC" url: "https://price"

Объект содержит базовый путь, который используется в запросах через API. Под базовым путём понимается часть адреса, которая находится перед конечной точкой. Servers можно гибко настраивать, например, указывая несколько адресов для тестирования:

servers: - url: https://api/ description: Production - url: http://beta/ Description: Other

Спецификация OpenAPI определяет path как объект для указания конечной точки. Каждый path содержит вложенный объект operations — методы GET, POST, PUT, DELETE . Например:

paths: /weather: get:

В этом объекте хранятся различные схемы спецификации. Схемы позволяют заметно ускорить процесс составления описаний. Например:

components: schemas: User: Properties: name: type: string

Теперь можно ссылаться на эту схему и при необходимости без проблем дополнять её новыми полями.

Объект для объявления того, какие механизмы безопасности можно использовать в API.

Например, требование безопасности OAuth2 :

Объект добавляет метаданные к тегу, который используется объектом operations . Например:

В этом объекте можно указать дополнительную информацию. Например:

Онлайн-редактор Swagger позволяет удобно работать над документацией со спецификацией. Он предлагает разделенный интерфейс. Слева вы пишете спецификацию, а справа видите отображение Swagger UI. В него даже можно отправлять запросы, чтобы сразу проверить правильность кода.

Использование Petstore для знакомства

Petstore — это простой пример, который помогает понять логику работу с интерфейсом Swagger. Сам сайт сгенерирован с помощью Swagger UI. Он предоставляет три конечные точки: user, store и pet . Вы можете выбрать протокол — HTTPS или HTTP.

Авторизация

Прежде всего нужно авторизоваться. Для этого нажмите на кнопку Authorize и заполните необходимую информацию.

В примере используется модель авторизации OAuth 2.0. На самом деле, код представлен в демонстрационных целях, никакой реальной логики за авторизацией нет. Так что можно просто закрыть окно.

Создание запроса

Создадим первый запрос к API. Для этого:

1. Разверните конечную точку POST/pet .
2. Нажмите на кнопку Try it out . После этого тело запроса станет редактируемым.
3. Найдите поле Example Value и измените id на случайное число.
4. Измените name на любое имя.
5. Нажмите Execute для выполнения запроса.

Система отправит запрос и покажет curl . Вы можете выбрать, в каком формате отобразить ответ — XML или JSON.

Проверка результата

Напоследок выполним ещё один запрос, чтобы убедиться, что питомец создан.

1. Разверните конечную точку GET/pet/ .
2. Нажмите на кнопку Try it out , чтобы сделать тело запроса редактируемым.
3. Введите id питомца, который вы указали ранее в запросе POST .
4. Нажмите Execute , чтобы выполнить запрос.

В ответе должно отобразиться имя созданного ранее питомца.

Это пример очень простой документации, которая позволяет быстро проверить работу доступных методов. Вы можете создать такой сайт самостоятельно или встроить интерфейс Swagger на страницу существующего ресурса — например, в справку о работе своего сервиса.

Как выглядят сайты с документацией Swagger UI

Вот ещё несколько примеров реализации Swagger:

• https://reverb.com/swagger#/feedback — описание API онлайн-магазина музыкальных инструментов.
• https://developers.themoviedb.org/3/account/mark-as-favorite — описание API базы данных фильмов и ТВ-шоу.

Обращает на себя внимание краткость документации, реализованной с помощью Swagger. Это объясняется тем, что сам по себе Swagger UI предназначен для интерактивного взаимодействия. Нет смысла читать пространные описания, когда можно просто выполнять указанные запросы и проверять, какие ответы приходят.

Как встроить Swagger UI в существующий сайт

При использовании Swagger UI необязательно использовать автономный сайт по типу Petstore . Можно встраивать Swagger в существующую страницу. Вот пример такой страницы:

Здесь встроен экземпляр Swagger UI, который показывает файл OpenAPI для OpenWeatherMapAPI . Выглядит как неплохо сверстанная документация, хотя в оформлении остались дефолтные элементы. При большом желании их тоже можно поменять. Гораздо важнее, что можно автоматизировать процесс обновления такой внешней документации.

Чтобы встроить Swagger UI на свой сайт:

1. Подготовьте документ спецификации OpenAPI.
2. Клонируйте себе или скачайте в виде архива с GitHub содержимое репозитория Swagger UI .
3. Извлеките папку dist . Остальные каталоги и файлы не понадобятся.
4. Перетащите созданные ранее файл OpenAPI в папку dist .
5. Откройте файл index.html в папке dist .
6. Найдите строку с URL. Там будет ссылка на Petstore: ‘ http://petstore.swagger.io/v2/swagger.json ’.
7. Замените URL. Вместо Petstore укажите относительную ссылку на ваш файл с документацией.
8. Сохраните изменения в файле index.html .

Отображение документации можно проверить локально. Если всё в порядке, загрузите папку dist (ее можно переименовать) на сервер и добавьте документацию на существующий сайт.

Подробную инструкцию можно найти на этой странице на GitHub .

Заключение

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

Чтобы разобраться со Swagger дополнительно, посмотрите эти видео или запишитесь на онлайн курсы от Mate Academy.

Например, вот доклад технического писателя из «Яндекса» о том, что такое вообще API и как работать со Swagger. Много времени также уделено практической части — в ней делается простой Swagger, который затем отображается в Swagger UI и в документации.

Ещё одно классное видео — подробное объяснение, как использовать Swagger: