Что такое Swagger и OpenAPI за 3 минуты
HTML-код
- Опубликовано: 26 сен 2024
- В этой статье мы узнаем:
- Что такое Swagger?
- Что такое OpenAPI?
- Разница между Swagger и OpenAPI
- Преимущества Swagger
- Принцип работы Swagger
Listen IT на Я.Дзене - zen.yandex.ru/...
Поддержать канал разово - yoomoney.ru/to...
Поддержать канал подпиской - boosty.to/list...
Телеграм-канал - t.me/listenit_...
По вопросам сотрудничества - t.me/ed_akimov
Ссылка на статью 1 - bizzapps.ru/p/...
Ссылка на статью 2 - docs.microsoft...
Что такое 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 з...
Нифига не понятно, но очень интересно
Ну вот кратко. как мы реализуем приложение:
- пишем код контроллеров для бекенда. Т.е. объяявляем эндпоинты, парсим и проверяем параметры, аутентификационны токен, возвращаем корректный код ошибки если что-то не так. Только после этого передаем данные в модель. И так для каждого эндпоинта.
- на клиенте придется писать код для генерации JSON-ов и отправки данных на эти эндпоинты.
- затем нужно писать документацию по API с примерами. По сути это означает копипастить код объявления эндпоинтов сервера и оформлять его в виде доков.
Много рутиной, и при этом повторяющейся работы. Но вместо этого можно использовать swagger:
- все API описывается на языке yaml в одном файле. Из этого файла можно автоматом сгенерировать код для эндпоинтов (со всеми проверками входных данных, с корректной обработкой ошибок), код клиента, а также интерактивную документацию с примерами.
@@angelicoctahedron3646 а есть где-нибудь толковый словарь всех этих терминов, чтобы хотя бы вкратце понять, о чём говорят все эти люди?)
Ну вот это совсем другое объяснение, а тут генерация документации, на кой хуй! @@angelicoctahedron3646
🤣
ибо сухая теория
Прочитать мы и сами можем, а объяснить уметь надо. Это не к вам.
Очень быстро, интересно, но почти, ничего не понятно)) Спасибо за ссылки на статьи, буду изучать 👍
Спасибо за видео, как только появится патреон с радостью подпишусь
Спасибо, рады слышать!
Спасибо за информацию) успехов с каналом!
Спасибо, заходите ещё 😉
Ахах, спасибо, кстати, что упомянули моё имя😅😅
Хоть это совсем не обязательно😅
Сделаю репост в месседжеры
Спасибо, будем признательны😌
А пока в процессе разработки видео про Middleware)
Я вообще ничего не понял. Ну, свагер создает какую-то автоматическую документацию где-то из чего-то. И? Вот и все?
Хотя бы один простой пример дал бы гораздо больше.
Программисты любят все формализировать в этом беда
Супер, все по делу! Хорошее видео что бы понять что.к чему на самом деле.
галопом по европам - ничего толком непонятно - просто набор слов привели бы примеры описаний на OpenAPI,примеры работы со Swager
Да там особо и нечего понимать фреймворк для описания APIдокументации
Оформление видео в стиле ретро - огонь! Поностальгировал по "старым добрым временам", когда только начинал свое знакомство с компьютером и такие интерфейсы были у программ.
Спасибо :)
Спасибо Вам большое 🤍
Ваш канал - лучик света для тех гиков, которым надо обязательно быть в курсе и постоянно узнавать что-то новое и полезное. 👍
ЗЫ: Аудитория не будет широкой, сразу говорю. Дело в языке - охват небольшой.
Спасибо большое за отзыв, очень приятно! Если не будет широкой аудитории, не так страшно - главное, чтобы всем тем, кто смотрит/слушает, было интересно :)
Swagger действительно очень удобный и наглядный инструментарий для RESTful 💪
Хорошее видео, но лучше схемой а не текстом
Слушать и читать этот же текст непросто
Но вообще, очень грустно видеть такую статистику. Когда у меня появиться возможность, я подпишусь на ваш патрион и постараюсь на сколько смогу спонсировать ваш проект.
Спасибо, очень приятно слышать! Придет время, и двинем на Патреон!
Ничего не понял вообще.
нифига не понятно(((
Зачетный у тебя канал. Понятно и доступно обьясняешь. Огромное спасибо за то что делишься информацией.
Тут, скорее, спасибо автору статьи, но все равно спасибо :)
Спасибо большое! Не могу ни как понять, у вас уже столько видео, почему же всего менее 100 просмотров?
Ну, всё постепенно) Ещё успеем горы свернуть!💪
Блин, думал своими словами расскажешь, а не читать...
"единая точка правды" - wtf?
Ничего не понятно(
Подача топ
Спасибо!
Как сделал оформление? Какой шрифт?
не хватает примеров с тем как свагер выглядит
Так что же такое open api?
напомните плз из какой игры звук в самом начале видео?) очень знакомо, чувствую флешбеки, а разблокировать воспоминание не могу)
В других видосах ребята уже спрашивали, посмотри) Подсказка: звук связан с помощью)
@@ListenIT_channel не нашёл таких комментариев, но это вроде как звук из Героев 3 (во время боя)
Набор слов, смысла их даже автор не знает..
Ни фига не понятно. Таким заумным языком объясняешь.... такое объяснение можно и загуглить, здесь люди ищут простое объяснение
Абсолютно ничего не понятно
Ничего не понятно
Пересказать википедию мой пахан тоже может, ролик заснять и на ютуб выставить с картинками, какой же ты гений, прочесть с листка все что написано в википедии, и закинуть в ютуб, для слепых что ли ролик делал, кто читать не умеет?
Ну и к чему это? Бесполезное видео, читать я и сам умею. Лучше бы объяснил на простом примере.
Понятный язык описания и низкий порог вхождения - это враньё, вы видели эти конфиги? Они как будто инопланетянами написаны, читать невозможно совершенно.
Ну не скажите, всё познаётся в сравнении. Файлы пишутся в формате JSON, а его структура вполне читаемая и человеко-понятная, даже если сравнивать с XML. Да, может, совсем с нуля, не зная, что такое JSON, сразу понятно не станет, но если потратить небольшое время на изучение формата JSON, то вникнуть можно вполне быстро.
Минус просто за Апи, просто три буквы Эй Пи Ай
фуфло
ролик для тех, кто не умеет читать?
См. описание канала
Режет слух это ваше "апи". Не апи, а эй-пи-ай.
не занудвствуй, все давно уже говорят АПИ
@@TheBaragoz В вашем ауле может и все, но в цивилизованном мире эй-пи-ай.
@@krown5666 в Microsoft, Cisco и Яндексе говорят АПИ, но раз для тебя это аул то пусть будет так)
@@TheBaragoz Аул - это то место, где ты вырос. Потому что только человек из аула будет говорить про весь Microsoft и Cisco. К твоему сведенью у Microsoft и Cisco есть несколько центров разработки в нескольких странах и судить по вашему местечковому российскому суржику в российских филиалах совсем не стоит. Все эти латинизмы вроде аш-тэ-тэ-пэ и ява вместо джава - хороший пример неправильного произношения.
@@krown5666 ох ты как бомбануло)) я именно про российские офисы и говорю. Ты вроде как тоже на русском пишешь?) А если у тебя так бомбит от произношения у тебя явно проблемы с головой. Иди лечись. Европейцы кстати тоже частенько сокращают все эти аббревиатуры для ускорения речи.
понапридумаеют херни всякой
Я первый раз столкнулся с этой темой.
И что-то мне это напоминает!
А напоминает мне это XML, SOAP и WSDL!
Там эти штуки вшиты в технологию.
точно
я тоже сразу вспомнил SOAP
да это какая-то тупая тенденция простые вещи усложнять кучей оболочек над оболочками. фронты настолько в этом преуспели что сделали круг и вновь пришли к "сервер-сайд-рендеринг"...
с примерами кода и даже левого но чем то похожего было б куда понятнее, а так без всех этих символов мне просто интересны алгоритмы