🚀 Неделя практики в 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. Что для этого могу сделать:
▪️ поспрашивать о впечатлениях у друзей, кто там был,
▪️ посмотреть стоимость авиаперелётов,
▪️ посмотреть, какие туры предлагаются.


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

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

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

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

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

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

Перед новым годом 💫

Конец года для меня всегда связан с подведением итогов. Общее по проекту я рассказала в предыдущем посте. А теперь о личном.

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

Это помогло во многом. Я стала еще спокойнее и увереннее. Наконец-то научилась отдыхать.

Было много разных ситуаций в этом году. Из хорошего - много путешествий и старт новой компании, рост GetAnalyst. Из плохого - буду помнить об ошибках и не буду повторять.

GetAnalyst очень приятно удивил в этом году. Рост в 3 раза по подписчикам, и еще больше по ученикам. Запущен instagram и телеграм-канал для начинающих в системном анализе с годным юмором и квизами.

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

Сделала контект в канале последовательным, чтобы на нем можно было учиться. И тем, кто только присоединился - я рекомендую на каникулаж пройти по закрепленным сообщениям и почитать 2-3 проекта в постах.

Я почти полностью отказалась от личного instagram, чему очень рада - меньше сожженного времени. Наверное мне нужно записывать короткие 1-2 минутные видео с общей информацией про СА, показывать свои путешествия и рассказывать как я наслаждаюсь жизнью на удаленке. Но я не хочу продавать вам иллюзии.

Я просто много работаю и уделяю внимание тем задачам, которые принесут вам больше пользы: структурированный контент в этом Telegram-канале, емкие практические вебинары и внутреннее обучение для меня пока важнее сториз в instagram.

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

Привет! Врываюсь к вам в 2024 со Swagger! 🟢🚀

В конце прошлого года я написала для вас инструкцию по первым шагам в освоении Swagger.

Представляю вам её продолжение:
🟢 Создание первого проекта в Swagger - базовое описание API.


Подробно разобрала по шагам:

1️⃣ Создание шаблона проекта.
2️⃣ Знакомство с основами спецификации OpenAPI 3.0 - написание кода. Спецификация используется не только в Swagger, но и в Postman.
3️⃣ Написание собственного кода для создания интерактивной API-документации.
4️⃣ Публикация результатов в открытый доступ.


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

Не пугайтесь количества страниц. Текста почти нет - много скриншотов для наглядности. Выполнение всех шагов по инструкции займёт от 10 до 30 минут.

Для тех, кому не удалось открыть https://swagger.io/ в прошлый раз: используйте VPN.


Ставьте 👍 у кого всё получилось и продолжим работать в Swagger дальше!

👀 Ищу Системных аналитиков 🔎

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

С прошлого года я держала это сообщение, так как были другие задачи, а делать всё и сразу невозможно. И вот - время пришло.


📌 Сообщество системных аналитиков GetAnalyst ищет опытных специалистов Middle+ / Senior для:
- Участия в вебинарах и подкастах с Екатериной Ананьевой,
- Помощи в развитии сообщества,
- Менторов.

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


Заполнить анкету и узнать подробности можно по ссылке.


Делитесь с опытными коллегами! Я хочу сделать нашу команду еще сильнее в 2024 году и дать вам больше востребованных и актуальных знаний! 🚀