Что такое Swagger и OpenAPI за 3 минуты
В этой статье мы узнаем:
- Что такое Swagger?
- Что такое OpenAPI?
- Разница между Swagger и OpenAPI
- Преимущества Swagger
- Принцип работы Swagger
Listen IT на Я.Дзене - zen.yandex.ru/listenit
Поддержать канал разово - yoomoney.ru/to/410012243709514
Поддержать канал подпиской - boosty.to/listenit
Телеграм-канал - t.me/listenit_channel
По вопросам сотрудничества - t.me/ed_akimov
Ссылка на статью 1 - bizzapps.ru/p/swagger/
Ссылка на статью 2 - docs.microsoft.com/ru-ru/aspn...
Что такое CI/CD - • Что такое CI/CD? Разби...
Что такое middleware за 7 минут - • Что такое middleware з...
Различия SOA и микросервисной архитектуры за 9 минут - • Различия SOA и микросе...
Различия REST и SOAP за 4 минуты - • Различия REST и SOAP з...
Введение в REST API за 7 минут - • Введение в REST API за...
Что такое HTTP и HTTPS за 9 минут - • Что такое HTTP и HTTPS...
Что такое CRUD за 6 минут - • Что такое CRUD за 6 минут
Что такое идемпотентность - • Что такое идемпотентно...
Что такое HATEOAS за 4 минуты - • Что такое HATEOAS за 4...
Что такое Code First подход за 4 минуты - • Что такое Code First п...
Что такое Contract First подход за 4 минуты - • Что такое Contract Fir...
Что такое Docker за 5 минут - • Что такое Docker за 5 ...
Что такое Kubernetes за 9 минут - • Что такое Kubernetes з...
Пікірлер: 71
Нифига не понятно, но очень интересно
@angelicoctahedron3646
2 жыл бұрын
Ну вот кратко. как мы реализуем приложение: - пишем код контроллеров для бекенда. Т.е. объяявляем эндпоинты, парсим и проверяем параметры, аутентификационны токен, возвращаем корректный код ошибки если что-то не так. Только после этого передаем данные в модель. И так для каждого эндпоинта. - на клиенте придется писать код для генерации JSON-ов и отправки данных на эти эндпоинты. - затем нужно писать документацию по API с примерами. По сути это означает копипастить код объявления эндпоинтов сервера и оформлять его в виде доков. Много рутиной, и при этом повторяющейся работы. Но вместо этого можно использовать swagger: - все API описывается на языке yaml в одном файле. Из этого файла можно автоматом сгенерировать код для эндпоинтов (со всеми проверками входных данных, с корректной обработкой ошибок), код клиента, а также интерактивную документацию с примерами.
@user-fq2fu8qi7z
Жыл бұрын
@@angelicoctahedron3646 а есть где-нибудь толковый словарь всех этих терминов, чтобы хотя бы вкратце понять, о чём говорят все эти люди?)
@mrakobes228
Ай бұрын
Ну вот это совсем другое объяснение, а тут генерация документации, на кой хуй! @@angelicoctahedron3646
@user-cp2dd4vt2p
Ай бұрын
🤣
Оформление видео в стиле ретро - огонь! Поностальгировал по "старым добрым временам", когда только начинал свое знакомство с компьютером и такие интерфейсы были у программ.
Прочитать мы и сами можем, а объяснить уметь надо. Это не к вам.
Супер, все по делу! Хорошее видео что бы понять что.к чему на самом деле.
Спасибо за информацию) успехов с каналом!
@ListenIT_channel
2 жыл бұрын
Спасибо, заходите ещё 😉
Спасибо за видео, как только появится патреон с радостью подпишусь
@ListenIT_channel
2 жыл бұрын
Спасибо, рады слышать!
Спасибо Вам большое 🤍
Я вообще ничего не понял. Ну, свагер создает какую-то автоматическую документацию где-то из чего-то. И? Вот и все? Хотя бы один простой пример дал бы гораздо больше.
@Roltun
11 ай бұрын
Программисты любят все формализировать в этом беда
Спасибо :)
Swagger действительно очень удобный и наглядный инструментарий для RESTful 💪
Ничего не понял вообще.
Ахах, спасибо, кстати, что упомянули моё имя😅😅 Хоть это совсем не обязательно😅 Сделаю репост в месседжеры
@ListenIT_channel
2 жыл бұрын
Спасибо, будем признательны😌 А пока в процессе разработки видео про Middleware)
Как сделал оформление? Какой шрифт?
Хорошее видео, но лучше схемой а не текстом Слушать и читать этот же текст непросто
нифига не понятно(((
Ваш канал - лучик света для тех гиков, которым надо обязательно быть в курсе и постоянно узнавать что-то новое и полезное. 👍 ЗЫ: Аудитория не будет широкой, сразу говорю. Дело в языке - охват небольшой.
@ListenIT_channel
2 жыл бұрын
Спасибо большое за отзыв, очень приятно! Если не будет широкой аудитории, не так страшно - главное, чтобы всем тем, кто смотрит/слушает, было интересно :)
Зачетный у тебя канал. Понятно и доступно обьясняешь. Огромное спасибо за то что делишься информацией.
@ListenIT_channel
Жыл бұрын
Тут, скорее, спасибо автору статьи, но все равно спасибо :)
Я первый раз столкнулся с этой темой. И что-то мне это напоминает! А напоминает мне это XML, SOAP и WSDL! Там эти штуки вшиты в технологию.
@Das.Kleine.Krokodil
Жыл бұрын
точно я тоже сразу вспомнил SOAP
@mercurykd
9 ай бұрын
да это какая-то тупая тенденция простые вещи усложнять кучей оболочек над оболочками. фронты настолько в этом преуспели что сделали круг и вновь пришли к "сервер-сайд-рендеринг"...
Но вообще, очень грустно видеть такую статистику. Когда у меня появиться возможность, я подпишусь на ваш патрион и постараюсь на сколько смогу спонсировать ваш проект.
@ListenIT_channel
2 жыл бұрын
Спасибо, очень приятно слышать! Придет время, и двинем на Патреон!
Спасибо большое! Не могу ни как понять, у вас уже столько видео, почему же всего менее 100 просмотров?
@ListenIT_channel
2 жыл бұрын
Ну, всё постепенно) Ещё успеем горы свернуть!💪
галопом по европам - ничего толком непонятно - просто набор слов привели бы примеры описаний на OpenAPI,примеры работы со Swager
@TheEegmen
3 ай бұрын
Да там особо и нечего понимать фреймворк для описания APIдокументации
Ничего не понятно(
напомните плз из какой игры звук в самом начале видео?) очень знакомо, чувствую флешбеки, а разблокировать воспоминание не могу)
@ListenIT_channel
Жыл бұрын
В других видосах ребята уже спрашивали, посмотри) Подсказка: звук связан с помощью)
@klast01
Жыл бұрын
@@ListenIT_channel не нашёл таких комментариев, но это вроде как звук из Героев 3 (во время боя)
Подача топ
@ListenIT_channel
Жыл бұрын
Спасибо!
"единая точка правды" - wtf?
Так что же такое open api?
Блин, думал своими словами расскажешь, а не читать...
с примерами кода и даже левого но чем то похожего было б куда понятнее, а так без всех этих символов мне просто интересны алгоритмы
не хватает примеров с тем как свагер выглядит
Набор слов, смысла их даже автор не знает..
Ни фига не понятно. Таким заумным языком объясняешь.... такое объяснение можно и загуглить, здесь люди ищут простое объяснение
Ничего не понятно
Минус просто за Апи, просто три буквы Эй Пи Ай
Абсолютно ничего не понятно
Пересказать википедию мой пахан тоже может, ролик заснять и на ютуб выставить с картинками, какой же ты гений, прочесть с листка все что написано в википедии, и закинуть в ютуб, для слепых что ли ролик делал, кто читать не умеет?
Понятный язык описания и низкий порог вхождения - это враньё, вы видели эти конфиги? Они как будто инопланетянами написаны, читать невозможно совершенно.
@ListenIT_channel
Жыл бұрын
Ну не скажите, всё познаётся в сравнении. Файлы пишутся в формате JSON, а его структура вполне читаемая и человеко-понятная, даже если сравнивать с XML. Да, может, совсем с нуля, не зная, что такое JSON, сразу понятно не станет, но если потратить небольшое время на изучение формата JSON, то вникнуть можно вполне быстро.
Ну и к чему это? Бесполезное видео, читать я и сам умею. Лучше бы объяснил на простом примере.
Режет слух это ваше "апи". Не апи, а эй-пи-ай.
@TheBaragoz
2 жыл бұрын
не занудвствуй, все давно уже говорят АПИ
@krown5666
2 жыл бұрын
@@TheBaragoz В вашем ауле может и все, но в цивилизованном мире эй-пи-ай.
@TheBaragoz
2 жыл бұрын
@@krown5666 в Microsoft, Cisco и Яндексе говорят АПИ, но раз для тебя это аул то пусть будет так)
@krown5666
2 жыл бұрын
@@TheBaragoz Аул - это то место, где ты вырос. Потому что только человек из аула будет говорить про весь Microsoft и Cisco. К твоему сведенью у Microsoft и Cisco есть несколько центров разработки в нескольких странах и судить по вашему местечковому российскому суржику в российских филиалах совсем не стоит. Все эти латинизмы вроде аш-тэ-тэ-пэ и ява вместо джава - хороший пример неправильного произношения.
@TheBaragoz
2 жыл бұрын
@@krown5666 ох ты как бомбануло)) я именно про российские офисы и говорю. Ты вроде как тоже на русском пишешь?) А если у тебя так бомбит от произношения у тебя явно проблемы с головой. Иди лечись. Европейцы кстати тоже частенько сокращают все эти аббревиатуры для ускорения речи.
ролик для тех, кто не умеет читать?
@ListenIT_channel
9 ай бұрын
См. описание канала
понапридумаеют херни всякой