🟢 Swagger

Возможности:
> Генерация интерактивной API-документации с использованием OpenAPI спецификации.
> Подходит для проектирования API с нуля, с возможностью визуального редактирования.
> Тестирование API прямо из создаваемой документации.
> Автогенерация API-документации на основе кода приложения благодаря OpenAPI спецификации.
> Поддержка OAuth и других механизмов аутентификации.

Преимущества:
+ Автоматическая документация AP на основе кода.
+ Поддержка OpenAPI Specification, что дает универсальность и стандартизацию для документирования API. OpenAPI сегодня также поддержан и в Postman.
+ Интерактивное тестирование API непосредственно из документации.
+ Сообщество и экосистема предоставляют множество плагинов и инструментов.

Недостатки:
- Начинающим может быть сложно разобраться во всех возможностях, и в целом с OpenAPI.
- Для тестирования API его почти не используют, в основном для написания документации.


🟣 insomnia - больше подходит для тестировщиков.

Возможности:
> Тестирование REST, SOAP, gRPC, GraphQL и др
> Загрузка проектов из Swagger.
> Возможность настройки окружений для тестирования (разработка, тестирование, прод и др.).
> Испольование переменных для упрощения и автоматизации тестов.
> Поддерживает автоматизацию тестов.
> Поддержка версионирования и совместной работы.
> Возможность расширения функциональности с помощью плагинов.

Преимущества:
+ Легок в освоении даже для начинающих.
+ Вся необходимая функциональность бесплатна.
+ Удобен для работы с GraphQL.
+ Активное сообщество: Множество руководств и поддержка сообщества.
+ Возможность создавать и прогонять тест-кейсы - полезно для тестировщиков.
+ Возможность поддержки версионности кейсов с подключением их к Git.

Недостатки:
- Может быть менее подходящим для очень сложных тестовых сценариев: В сравнении с такими инструментами как SoapUI, функционал Insomnia может показаться ограниченным.
- Недостаток интеграций по сравнению с Postman: Хотя Insomnia поддерживает плагины, общее количество интеграций и расширений может быть меньше.

Нагрузочное тестирование 🥲

А еще рекомендуют знать про JMeter. Стоит взять на заметку, если вдруг придется столкнуться с анализом нагрузок на систему и надо будет что-то подсказать разработчикам.

Возможности:
> Нагрузочное и стрессовое тестирование.
> Тестирование производительности веб-приложений.
> Поддержка многопоточности и симуляция одновременного доступа множества пользователей.
> Запись и воспроизведение тестовых сценариев.
> Графическое представление результатов тестирования.


Заключение:

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

Из опыта скажу, что в 90% работы я использую Postman.

Для тестирования SOAP API я обращаюсь к SOAP UI.

Для разработки API-документации тоже использую Postman, но и Swagger в этом деле идеальный помощник, просто более сложный.

Insomnia использовали коллеги-тестировщики, а JMeter однажды разработчики 🙂


Выбор определенного инструмента зависит от конкретных требований и целей тестирования.

Зачем быть частью сообщества, если можно и без этого жить? 🧐

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

Если ваша цель — прокачивать себя и выстраивать сильное окружение вокруг, то стоит об этом помнить 😏

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

Они помогают нам раскрыться, посмотреть на мир под другим углом. А ещё это классный шанс увидеть свои точки роста 💫

Я искренне радуюсь, когда подсвечиваю эти «точки» студентам GetAnalyst. Мне нравится говорить о том, как можно достигнуть новых высот, ставить новые цели в карьере, планировать новые проекты. Безумно приятно потом узнавать, что для кого-то общение стало судьбоносным и повлияло на жизнь.

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

Особенно я люблю живые вебинары и воркшопы ❣️Мне важно быть живой, видеть вашу реакцию, получать обратную связь. После таких встреч я настолько заряжаюсь, что уверена — моей энергии хватит, чтобы поддерживать в тепле как минимум один большой мегаполис! Или запустить ракету в космос 🚀

Спасибо Вам, что вы стали частью GetAnalyst. Спасибо всем, кто прошел с нами путь роста в этом году! ❤🦭

🚀 Неделя практики в Swagger 🚀

Последнюю неделю этого года я решила посвятить освоению инструмента документирования API - Swagger, востребованного во многих IT-компаниях для позиции Системного аналитика.

Swagger – это набор инструментов для работы с OpenAPI Specification (OAS). Он помогает разработчикам и системным аналитикам проектировать, документировать и использовать RESTful API сервисы. С его помощью можно легко создавать интерактивную API-документацию.


Swagger включает две основные части, которые я хочу выделить, и которыми я пользуюсь:

🟢 Swagger Editor - с помощью этого инструмента создается в ручном режиме документация. Самое сложное в этом процессе - OpenAPI спецификация, которая по сути является языком разметки или языком программирования для описания документации.

🟢 Swagger API-Documentation - результат того, что вы создали в Swagger Editor - API-документация, с помощью которой можно сразу проверять API.

Также документацию можно собирать автоматически, на основе программного кода. Но в этом случае её редактирование аналитиком невозможно.


Примеры Swagger-документации:

🔗 PetSore - демо-проект Swagger документации, на котором предлагается осваивать инструмент.

🔗 Aviasales B2B API - документация для партнеров известного нам сервиса для бронирования авиабилетов.

🔗API-продавца WB - Статистика - пользователям Wildberries будет полезно посмотреть, что по статистике продаж смотрит бизнес через Wildberries API.


Для того, чтобы научиться создавать аналогичную документацию, необходимо освоить инструмент Swagger Editor и OpenAPI спецификацию.

🟢 Swagger Editor - начало работы 🟢

Я не я, если начну давать вам части кода по OpenAPI и объяснять, без возможности пощупать - попробовать на практике.

Поэтому на сегодня у меня для вас есть задание: зарегистрироваться и сделать первые шаги в Swagger Editor.

1. Регистрируетесь в Swagger.
2. Создаете свой первый тестовый проект.

Всё очень просто! 😃

А чтобы вам помочь, я подготовила инструкцию с картинками.

Кто выполнил все шаги и готов идти дальше - ❤️ под публикацию!

Как ставить цели, чтобы расти по всем сферам?

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

Уверена, многие с ней знакомы, а возможно даже и пробовали.

Кто не пробовал, рекомендую попробовать её до конца года или на новогодних каникулах ⤵️


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

Можете выбрать 12 на год, а можете только 10, потому что остальные и так на комфортном уровне и их надо просто поддерживать.

Сферы:
1. Здоровье,
2. Физическое состояние,
3. Карьера и профессиональный рост,
4. Личные и семейные отношения,
5. Путешествия,
6. Друзья,
7. Эмоциональное и психологическое благополучие,
8. Хобби и увлечения,
9. Обстановка, в которой вы живете - дом,
10. Интеллектуальное развитие, расширение кругозора,
11. Самооценка,
12. Духовное развитие - медитации, духовные практики.

Дальше по каждой сфере:

1. Отвечаем на вопрос - что не устраивает сейчас?
2. Ставим цель, к которой планируем прийти.
3. Пишем простую привычку, которую надо внедрить, или 3 действия, чтобы изменения произошли.

Продолжение 👇

Например - Карьера:

1. Не устраивает текущая компания из-за скучных проектов и отсутствия повышения.
2. Хочу сменить работу.
3. Что для этого могу сделать:
▪️ обновить резюме,
▪️ посмотреть навыки, которые сейчас требуются на желаемой должности,
▪️ актуализировать знания, пройти обучение.

Или пример - Путешествия:

1. Я вечно откладываю свое желанное путешествие в Индию.
2. Хочу отпуск в Индии.
3. Что для этого могу сделать:
▪️ поспрашивать о впечатлениях у друзей, кто там был,
▪️ посмотреть стоимость авиаперелётов,
▪️ посмотреть, какие туры предлагаются.


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

И так по каждой сфере.

Да, это может занять продолжительное время, но, поверьте, с уже прописанными тремя действиями вам будет двигаться гораздо проще и быстрее.

Желаю, чтобы у каждого осуществлялись их мечты и цели 💫

Сохраняйте веру в себя и свои возможности, идите к целям шаг за шагом, не останавливаясь на достигнутом!

Всем удачи и успехов в реализации ❤